Method: projects.locations.backends.domains.patch

لتعديل معلومات نطاق واحد.

طلب HTTP

PATCH https://firebaseapphosting.googleapis.com/v1beta/{domain.name=projects/*/locations/*/backends/*/domains/*}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
domain.name

string

المُعرّف. اسم مورد النطاق، على سبيل المثال /projects/p/locations/l/backends/b/domains/foo.com

معامِلات طلب البحث

المَعلمات
updateMask

string (FieldMask format)

مطلوب. يُستخدَم قناع الحقل لتحديد الحقول المطلوب استبدالها في مورد "النطاق" من خلال التعديل. ترتبط الحقول المحدّدة في قناع التحديث بالمورد، وليس بالطلب الكامل. سيتم استبدال الحقل إذا كان داخل القناع. إذا لم يضع المستخدم قناعًا، سيتم استبدال جميع الحقول.

هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo".

requestId

string

هذه السمة اختيارية. رقم تعريف طلب اختياري لتحديد الطلبات. يمكنك تحديد معرّف طلب فريد حتى إذا تمت إعادة محاولة طلبك، سيعرف الخادم أنّه يتجاهل الطلب في حال اكتماله. سيضمن الخادم ذلك لمدة 60 دقيقة على الأقل منذ أول طلب.

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

يجب أن يكون معرّف الطلب هو معرّف فريد عالمي (UUID) صالح باستثناء أنّ القيمة صفر UUID غير متوافقة (00000000-0000-0000-0000-000000000000).

validateOnly

boolean

هذه السمة اختيارية. تشير إلى أنّه يجب التحقّق من صحة الطلب وتعبئة القيم التلقائية بدون مواصلة الطلب أو تعديل أي موارد.

allowMissing

boolean

هذه السمة اختيارية. إذا تم ضبطها على "صحيح"، ولم يتم العثور على النطاق، سيتم إنشاء نطاق جديد.

نص الطلب

يحتوي نص الطلب على مثيل Domain.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Operation.

نطاقات الأذونات

يتطلب نطاق OAuth التالي:

  • https://www.googleapis.com/auth/cloud-platform

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.