Method: projects.availableLocations.list

يسرد مواقع موارد 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

string

FirebaseProject الذي سيتم إدراج مواقع موارد Google Cloud Platform له، بالتنسيق:

projects/ PROJECT_IDENTIFIER

ارجع إلى حقل name FirebaseProject للحصول على تفاصيل حول قيم PROJECT_IDENTIFIER .

إذا لم يتم تحديد معرف مشروع فريد (أي، projects/- )، فإن القائمة التي تم إرجاعها لا تأخذ في الاعتبار القيود الخاصة بالمؤسسة أو الموقع الخاص بالمشروع.

معلمات الاستعلام

حدود
pageToken

string

تم إرجاع الرمز المميز من استدعاء سابق إلى availableLocations.list للإشارة إلى مكان استئناف الإدراج في قائمة المواقع.

pageSize

integer

الحد الأقصى لعدد المواقع المراد إرجاعها في الاستجابة.

قد يقوم الخادم بإرجاع قيمة أقل من هذه القيمة وفقًا لتقديره. إذا لم يتم تحديد أي قيمة (أو تم تحديد قيمة كبيرة جدًا)، فسيفرض الخادم حدًا خاصًا به.

لا يمكن أن تكون هذه القيمة سالبة.

هيئة الطلب

يجب أن يكون نص الطلب فارغًا.

هيئة الاستجابة

في حالة النجاح، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل جيسون
{
  "locations": [
    {
      object (Location)
    }
  ],
  "nextPageToken": string
}
مجالات
locations[]

object ( Location )

صفحة واحدة من نتائج الاتصال بـ availableLocations.list .

nextPageToken

string

إذا كانت قائمة النتائج كبيرة جدًا بحيث لا يمكن احتواؤها في استجابة واحدة، فسيتم إرجاع الرمز المميز. إذا كانت السلسلة فارغة، فإن هذه الاستجابة هي الصفحة الأخيرة من النتائج وقد تم إدراج جميع المواقع المتاحة.

يمكن استخدام هذا الرمز المميز في استدعاء لاحق لـ availableLocations.list للعثور على المزيد من المواقع.

الرموز المميزة للصفحة قصيرة العمر ويجب عدم استمرارها.

نطاقات التفويض

يتطلب أحد نطاقات 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 (LocationType),
  "features": [
    enum (LocationFeature)
  ]
}
مجالات
locationId

string

معرف موقع مورد Google Cloud Platform. وسيكون أحد مواقع موارد Google Cloud Platform المتاحة.

type

enum ( LocationType )

يشير إلى ما إذا كان موقع مورد Google Cloud Platform موقعًا إقليميًا أو متعدد المناطق للنسخ المتماثل للبيانات.

features[]

enum ( LocationFeature )

المنتجات والخدمات المتوفرة في موقع موارد 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 في هذا الموقع.