Method: projects.locations.backends.domains.create

يربط نطاقًا جديدًا بواجهة خلفية.

طلب HTTP

POST https://firebaseapphosting.googleapis.com/v1beta/{parent=projects/*/locations/*/backends/*}/domains

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

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

المَعلمات
parent

string

مطلوب. الواجهة الخلفية الرئيسية بالتنسيق:

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

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

المَعلمات
domainId

string

مطلوب. معرِّف النطاق المراد إنشاؤه. يجب أن يكون اسم نطاق صالحًا.
requestId

string

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

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

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

boolean

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

نص الطلب

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

نص الاستجابة

في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Operation تم إنشاؤه حديثًا.

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

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

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

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