REST Resource: projects.locations.backends

المورد: الخلفية

الخلفية هي المورد الأساسي لـ "استضافة التطبيق".

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "servingLocality": enum (ServingLocality),
  "codebase": {
    object (Codebase)
  },
  "uri": string,
  "managedResources": [
    {
      object (ManagedResource)
    }
  ],
  "serviceAccount": string,
  "appId": string,
  "environment": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
الحقول
name

string

المُعرّف. اسم المورد للخلفية

طبيعة الحضور:

projects/{project}/locations/{locationId}/backends/{backendId}.
displayName

string

هذه السمة اختيارية. اسم يمكن للمستخدمين قراءته عدد الأحرف المسموح به هو 63 حرفًا
servingLocality

enum (ServingLocality)

مطلوب. غير قابل للتغيير. تحدِّد هذه السياسة طريقة عرض "استضافة التطبيق" للمحتوى لهذه الواجهة الخلفية. ستقتصر الخدمة إما على منطقة واحدة (RegionAL_STRICT) أو سيُسمح لها باستخدام البنية الأساسية للعرض العالمي المتكررة (GLOBAL_ACCESS) لخدمة App Hosting.
codebase

object (Codebase)

هذه السمة اختيارية. الاتصال بمستودع مصدر خارجي لمراقبة التحديثات المستندة إلى الحدث التي يتم إجراؤها في الخلفية، في حال تحديدها
uri

string

النتائج فقط. معرّف الموارد المنتظم (URI) الأساسي للاتصال بالخلفية.
managedResources[]

object (ManagedResource)

النتائج فقط. قائمة بالموارد التي تديرها هذه الخلفية
serviceAccount

string

مطلوب. اسم حساب الخدمة المستخدَم في Cloud Build وCloud Run يجب أن يتوفّر له دور الأدوار/firebaseapphosting.googleapis.com/computeRunner أو أذونات مكافئة.
appId

string

هذه السمة اختيارية. رقم تعريف تطبيق ويب مرتبط بالخلفية.
environment

string

هذه السمة اختيارية. اسم البيئة الخلفية، يُستخدم لتحميل متغيّرات البيئة من الإعدادات الخاصة بالبيئة الخلفية
reconciling

boolean

النتائج فقط. يشير ذلك المصطلح إلى حقل يشير، إذا كان صحيحًا، إلى أنّ النظام يعمل على إجراء تعديلات على الخلفية أثناء عملية LRO.
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء الواجهة الخلفية

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

النتائج فقط. وقت آخر تحديث للخلفية

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
deleteTime

string (Timestamp format)

النتائج فقط. وقت حذف الواجهة الخلفية

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
labels

map (key: string, value: string)

هذه السمة اختيارية. خريطة غير منظَّمة للقيم الرئيسية يمكن استخدامها لتنظيم العناصر وتصنيفها

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
annotations

map (key: string, value: string)

هذه السمة اختيارية. يشير ذلك المصطلح إلى خريطة غير منظَّمة لقيمة المفتاح التي قد تضبطها أدوات خارجية لتخزين البيانات الوصفية العشوائية. لا يمكن إجراء طلبات بحث عنها ويجب الاحتفاظ بها عند تعديل العناصر.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
uid

string

النتائج فقط. معرّف فريد يحدّده النظام
etag

string

النتائج فقط. المجموع الاختباري الذي احتسبه الخادم استنادًا إلى قيم أخرى عند التحديث أو الحذف لضمان إتمام العملية في المورد المتوقع.

منطقة الخدمة

يحدِّد هذا الإعداد كيفية تكرار "استضافة التطبيق" لبيانات الخلفية وعرضها.

تعدادات
SERVING_LOCALITY_UNSPECIFIED غير محدَّد ستعرض رسالة خطأ في حال استخدامها.
REGIONAL_STRICT في هذا الوضع، تعرض App Hosting محتوى الخلفية من المنطقة الرئيسية التي اخترتها. تحتفظ خدمة "استضافة التطبيقات" بالبيانات والبنية الأساسية للعرض فقط في تلك المنطقة المحدّدة، ولا تنسخ بياناتك إلى مناطق أخرى.
GLOBAL_ACCESS في هذا الوضع، تعرض "استضافة التطبيقات" محتوى الخلفية من نقاط تواجد متعددة (POP) في جميع أنحاء العالم. تنسخ ميزة "استضافة التطبيق" إعدادات الخلفية والبيانات المخزَّنة مؤقتًا إلى خوادم بروتوكول مكتب البريد (POP) هذه وتستخدم شبكة توصيل محتوى (CDN) عالمية لتقليل وقت استجابة الاستجابة بشكل أكبر. لا تزال موارد السحابة الإلكترونية التي تتم صيانتها من خلال "استضافة التطبيق" في مشروعك، مثل خدمات Cloud Run وCloud Build وصور Artifact Registry محصورة في المنطقة الرئيسية للخلفية. ويمكن أن يتم تخزين الاستجابات المُخزنة بواسطة شبكة توصيل المحتوى (CDN) في بروتوكولات POP طوال مدة مدة بقاء ذاكرة التخزين المؤقت.

قاعدة الرموز

يشير ذلك المصطلح إلى الاتصال بمستودع مصدر خارجي لرصد أي تحديثات تتم على مستوى الحدث في الخلفية.

تمثيل JSON 
{
  "repository": string,
  "rootDirectory": string
}
الحقول
repository

string

مطلوب. اسم المورد لـ Developer Connect gitRepositoryLink المرتبط بهذه الخلفية، بالتنسيق:

project/{project}/locations/{location}/connections/{connection}/gitRepositoryLinks/{repositoryLink}

يجب أن يكون ربط gitRepositoryLink باستخدام تطبيق GitHub لاستضافة التطبيقات في Firebase عبر وحدة تحكُّم Firebase.
rootDirectory

string

هذه السمة اختيارية. إذا تم توفير repository، يتم الدليل الخاص بجذر المستودع لاستخدامه كجذر لتطبيق الويب المنشور.

موارد مُدارة

مورد خارجي تتم إدارته بواسطة "استضافة التطبيقات" في المشروع.

تمثيل JSON 
{

  // Union field managed_resource can be only one of the following:
  "runService": {
    object (RunService)
  }
  // End of list of possible types for union field managed_resource.
}
الحقول

حقل الاتحاد managed_resource.

يمكن أن يكون managed_resource واحدًا فقط مما يلي:
runService

object (RunService)

تشغيل في السحابة الإلكترونية service تديره خدمة استضافة التطبيقات.

تشغيل الخدمة

حساب مُدار في السحابة الإلكترونية service.

تمثيل JSON 
{
  "service": string
}
الحقول
service

string

هذه السمة اختيارية. اسم تشغيل السحابة الإلكترونية service بالتنسيق:

project/{project}/locations/{location}/services/{serviceId}

الطُرق

create

 تنشئ واجهة خلفية جديدة في مشروع وموقع محدَّدَين

delete

 لحذف واجهة خلفية واحدة.

get

 الحصول على معلومات حول الواجهة الخلفية

getTraffic

 الحصول على معلومات عن عدد زيارات الخلفية

list

 يسرد الخلفيات في مشروع وموقع معين.

patch

 لتعديل معلومات واجهة خلفية واحدة.

updateTraffic

 تعمل على تعديل عدد الزيارات في إحدى الخلفيات.