Method: projects.locations.backends.updateTraffic

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

طلب HTTP

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

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

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

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

string

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

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

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

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

المَعلمات
updateMask

string (FieldMask format)

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

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

string

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

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

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

boolean

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

نص الطلب

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

نص الاستجابة

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

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

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

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

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