يسرد مواقع موارد Google Cloud Platform (GCP) الصالحة للمشروع المحدد (بما في ذلك FirebaseProject
).
يمكن تحديد أحد هذه المواقع ليكون موقع موارد Google Cloud Platform الافتراضي للمشروع، وهو الموقع الجغرافي حيث سيتم توفير موارد المشروع، مثل Cloud Firestore، بشكل افتراضي. ومع ذلك، إذا تم بالفعل تعيين موقع مورد Google Cloud Platform الافتراضي للمشروع، فلا يمكن تغيير هذا الإعداد.
تتحقق هذه المكالمة من أي قيود محتملة على الموقع للمشروع المحدد، وبالتالي، قد تُرجع مجموعة فرعية من جميع مواقع موارد Google Cloud Platform المحتملة. لسرد جميع مواقع موارد Google Cloud Platform (بغض النظر عن أي قيود)، اتصل بنقطة النهاية دون تحديد معرف مشروع فريد (أي، /v1beta1/{parent=projects/-}/listAvailableLocations
).
للاتصال بـ availableLocations.list
بمشروع محدد، يجب أن يكون العضو عارضًا للمشروع على الأقل. المكالمات بدون مشروع محدد لا تتطلب أي أذونات مشروع محددة.
طلب HTTP
GET https://firebase.googleapis.com/v1beta1/{parent=projects/*}/availableLocations
يستخدم عنوان URL بناء جملة gRPC Transcoding .
معلمات المسار
حدود | |
---|---|
parent | ارجع إلى حقل إذا لم يتم تحديد معرف مشروع فريد (أي، |
معلمات الاستعلام
حدود | |
---|---|
pageToken | تم إرجاع الرمز المميز من استدعاء سابق إلى |
pageSize | الحد الأقصى لعدد المواقع المراد إرجاعها في الاستجابة. قد يقوم الخادم بإرجاع قيمة أقل من هذه القيمة وفقًا لتقديره. إذا لم يتم تحديد أي قيمة (أو تم تحديد قيمة كبيرة جدًا)، فسيفرض الخادم حدًا خاصًا به. لا يمكن أن تكون هذه القيمة سالبة. |
هيئة الطلب
يجب أن يكون نص الطلب فارغًا.
هيئة الاستجابة
في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل جيسون |
---|
{
"locations": [
{
object ( |
مجالات | |
---|---|
locations[] | صفحة واحدة من نتائج الاتصال بـ |
nextPageToken | إذا كانت قائمة النتائج كبيرة جدًا بحيث لا يمكن احتواؤها في استجابة واحدة، فسيتم إرجاع الرمز المميز. إذا كانت السلسلة فارغة، فإن هذه الاستجابة هي الصفحة الأخيرة من النتائج وقد تم إدراج جميع المواقع المتاحة. يمكن استخدام هذا الرمز المميز في استدعاء لاحق لـ الرموز المميزة للصفحة قصيرة العمر ويجب عدم استمرارها. |
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/cloud-platform.read-only
-
https://www.googleapis.com/auth/firebase
-
https://www.googleapis.com/auth/firebase.readonly
لمزيد من المعلومات، راجع نظرة عامة على المصادقة .
موقع
موقع مورد Google Cloud Platform الذي يمكن تحديده لـ FirebaseProject
.
تمثيل جيسون |
---|
{ "locationId": string, "type": enum ( |
مجالات | |
---|---|
locationId | معرف موقع مورد Google Cloud Platform. وسيكون أحد مواقع موارد Google Cloud Platform المتاحة. |
type | يشير إلى ما إذا كان موقع مورد Google Cloud Platform موقعًا إقليميًا أو متعدد المناطق للنسخ المتماثل للبيانات. |
features[] | المنتجات والخدمات المتوفرة في موقع موارد Google Cloud Platform. |
نوع الموقع
يحدد كيفية نسخ البيانات داخل موقع مورد Google Cloud Platform. تعرف على المزيد حول أنواع مواقع موارد Google Cloud Platform .
التعدادات | |
---|---|
LOCATION_TYPE_UNSPECIFIED | يستخدم داخليًا لتمييز القيم غير المحددة وليس مخصصًا للاستخدام الخارجي. |
REGIONAL | الموقع هو موقع إقليمي. يتم نسخ البيانات الموجودة في موقع إقليمي في مناطق متعددة داخل المنطقة. |
MULTI_REGIONAL | الموقع هو موقع متعدد المناطق. يتم نسخ البيانات الموجودة في موقع متعدد المناطق في مناطق متعددة. داخل كل منطقة، يتم نسخ البيانات في مناطق متعددة. |
ميزة الموقع
المنتجات والخدمات المتوفرة في موقع موارد Google Cloud Platform.
التعدادات | |
---|---|
LOCATION_FEATURE_UNSPECIFIED | يستخدم داخليًا لتمييز القيم غير المحددة وليس مخصصًا للاستخدام الخارجي. |
FIRESTORE | يدعم هذا الموقع مثيلات قاعدة بيانات Cloud Firestore. يتوفر App Engine في هذا الموقع، لذا يمكن أن يكون موقع موارد Google Cloud Platform الافتراضي للمشروع. |
DEFAULT_STORAGE | يدعم هذا الموقع مجموعات التخزين السحابية الافتراضية. يتوفر App Engine في هذا الموقع، لذا يمكن أن يكون موقع موارد Google Cloud Platform الافتراضي للمشروع. |
FUNCTIONS | تتوفر الوظائف السحابية لـ Firebase في هذا الموقع. |