REST Resource: projects.locations.backends.domains

المورد: النطاق

يشير ذلك المصطلح إلى اسم نطاق مرتبط بواجهة خلفية.

تمثيل JSON
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "type": enum (Type),
  "disabled": boolean,
  "serve": {
    object (ServingBehavior)
  },
  "customDomainStatus": {
    object (CustomDomainStatus)
  },
  "reconciling": boolean,
  "deleteTime": string,
  "purgeTime": string,
  "labels": {
    string: string,
    ...
  },
  "annotations": {
    string: string,
    ...
  },
  "uid": string,
  "etag": string
}
الحقول
name

string

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

displayName

string

هذه السمة اختيارية. اسم النطاق قابل للتغيير ويمكن لشخص عادي قراءته عدد الأحرف المسموح به هو 63 حرفًا مثلاً: prod domain

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".

type

enum (Type)

النتائج فقط. نوع النطاق.

disabled

boolean

هذه السمة اختيارية. ما إذا كان النطاق غير مفعَّل. وتكون القيمة التلقائية على "خطأ".

serve

object (ServingBehavior)

هذه السمة اختيارية. طريقة عرض النطاق وفي حال تحديد هذا الخيار، سيعرض النطاق محتوى آخر غير المحتوى المباشر لواجهته الخلفية.

customDomainStatus

object (CustomDomainStatus)

النتائج فقط. يمثل ذلك حالة النطاق من النوع CUSTOM وإعداداته. لا تتوفّر إلا على نطاقات من هذا النوع.

reconciling

boolean

النتائج فقط. يشير ذلك المصطلح، إذا كانت القيمة إلى "صحيح"، إلى أنّ الإصدار يتضمّن مهمة LRO جارية.

deleteTime

string (Timestamp format)

النتائج فقط. وقت حذف النطاق.

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

purgeTime

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

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

النوع

نوع النطاق.

تعدادات
TYPE_UNSPECIFIED النوع غير محدد (لا ينبغي أن يحدث هذا).
DEFAULT النطاقات التلقائية، سواء كانت متاحة أو مُدارة من خلال "استضافة التطبيقات". يتم إنشاء هذه النطاقات تلقائيًا باستخدام الواجهة الخلفية لها ولا يمكن حذفها إلا من خلال حذف ذلك النطاق الرئيسي، ولا يمكن نقلها إلى واجهة خلفية أخرى. يمكن إيقاف النطاقات التلقائية من خلال الحقل disabled.
CUSTOM النطاقات المخصَّصة التي يملكها المطوِّر تتيح لك النطاقات المخصَّصة ربط نطاق تملكه بواجهة استضافة التطبيقات، وإعداد هذا النطاق لعرض محتوى الخلفية.

سلوك العرض

يشير إلى ما إذا كانت استضافة التطبيق ستعرض المحتوى على النطاق.

تمثيل JSON
{

  // Union field serving_behavior can be only one of the following:
  "redirect": {
    object (Redirect)
  }
  // End of list of possible types for union field serving_behavior.
}
الحقول
حقل الاتحاد serving_behavior. يؤدي تحديد هذا الخيار إلى تخصيص سلوك عرض النطاق. يمكن أن يكون serving_behavior واحدًا فقط مما يلي:
redirect

object (Redirect)

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

إعادة توجيه

تحدِّد هذه السياسة سلوك إعادة التوجيه لنطاق معيّن.

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

string

مطلوب. معرّف الموارد المنتظم (URI) لوجهة إعادة التوجيه. ستتم إضافة معرّف الموارد المنتظم (URI) هذا إلى مسار الطلب الأصلي. يُفترض أن يكون معرف الموارد المنتظم (URI) بدون مخطط هو HTTPS.

status

string (int64 format)

هذه السمة اختيارية. رمز الحالة المطلوب استخدامه في استجابة إعادة التوجيه. يجب أن يكون رمز حالة HTTP 3XX صالحًا. وتكون القيم التلقائية 302 في حال عدم توفّرها.

حالة النطاق المخصص

حالة ربط نطاق خاص بواجهة خلفية.

تمثيل JSON
{
  "hostState": enum (HostState),
  "ownershipState": enum (OwnershipState),
  "certState": enum (CertState),
  "requiredDnsUpdates": [
    {
      object (DnsUpdates)
    }
  ],
  "issues": [
    {
      object (Status)
    }
  ]
}
الحقول
hostState

enum (HostState)

النتائج فقط. لتتبُّع ما إذا كان قد تم رصد نطاق خاص على أنه يوجّه الزيارات بشكلٍ مناسب إلى "استضافة التطبيقات".

ownershipState

enum (OwnershipState)

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

certState

enum (CertState)

النتائج فقط. لتتبُّع حالة شهادة طبقة المقابس الآمنة (SSL) للنطاق

requiredDnsUpdates[]

object (DnsUpdates)

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

issues[]

object (Status)

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

حالة المضيف (HostState)

حالة المضيف لنطاقك. يتم تحديد حالة المضيف عن طريق التحقق من كل عنوان IP مرتبط بنطاقك لمعرفة ما إذا كان يتم عرضه من خلال الجزء المناسب من مصدر استضافة التطبيق.

تعدادات
HOST_STATE_UNSPECIFIED لم يتم تحديد حالة مضيف نطاقك الخاص. تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك.
HOST_UNHOSTED نطاقك الخاص غير مرتبط بأي عناوين IP.
HOST_UNREACHABLE لا يمكن الوصول إلى نطاقك الخاص. خدمات استضافة التطبيقات" أدت طلبات بحث نظام أسماء النطاقات للعثور على عناوين IP لنطاقك إلى حدوث أخطاء. لمزيد من التفاصيل، اطّلِع على حقل "issues" في CustomDomainStatus.
HOST_NON_FAH يحتوي نطاقك على عناوين IP فقط لا تؤدي في النهاية إلى استضافة التطبيقات.
HOST_CONFLICT يحتوي نطاقك على عناوين IP يمكن استخدامها مع كل من "استضافة التطبيقات" والخدمات الأخرى. لضمان الحصول على نتائج متسقة، يُرجى إزالة سجلّات A وAAAA ذات الصلة بخدمات غير استضافة التطبيقات.
HOST_WRONG_SHARD يحتوي نطاقك على عناوين IP يتم تحويلها إلى منطقة غير صحيحة و/أو جزء مكرر من "استضافة التطبيق".
HOST_ACTIVE تقدّم "استضافة التطبيقات" جميع الطلبات الموجّهة إلى نطاقك، من خلال الجزء المخصّص لنطاقك. إذا كان OwnershipState للنطاق الخاص هو OWNERSHIP_ACTIVE أيضًا، تعرض "استضافة التطبيق" محتوى الخلفية في طلبات النطاق.

حالة الملكية

حالة ملكية النطاق الخاص

تعدادات
OWNERSHIP_STATE_UNSPECIFIED لم يتم تحديد حالة ملكية نطاقك الخاص. من المفترض ألا يحدث هذا مطلقًا.
OWNERSHIP_MISSING لا يحتوي النطاق الخاص بك على سجلات ملكية مرتبطة باستضافة التطبيقات. لا يُسمح بعرض أي واجهة خلفية على النطاق في جزء المصدر هذا.
OWNERSHIP_UNREACHABLE لا يمكن الوصول إلى نطاقك الخاص. خدمات استضافة التطبيقات" أدّت طلبات بحث نظام أسماء النطاقات للعثور على سجلّات ملكية نطاقك إلى حدوث أخطاء. لمزيد من التفاصيل، اطّلِع على حقل "issues" في CustomDomainStatus.
OWNERSHIP_MISMATCH نطاقك الخاص يملكه نطاق خاص آخر لاستضافة التطبيقات. إزالة السجلات المتعارضة واستبدالها بسجلات نطاقك الخاص الحالي
OWNERSHIP_CONFLICT يحتوي نطاقك الخاص على سجلات TXT متعارضة تشير إلى ملكية نطاقك الخاص الحالي واحد أو أكثر. عليك إزالة سجلّات الملكية غير الضرورية لمنح ملكية النطاق الخاص الحالي.
OWNERSHIP_PENDING تم ضبط سجلّات نظام أسماء النطاقات لنطاقك الخاص بشكل صحيح. ستنقل خدمة "استضافة التطبيق" ملكية نطاقك إلى هذا النطاق الخاص في غضون 24 ساعة.
OWNERSHIP_ACTIVE نطاقك الخاص يملك نطاقه.

حالة الشهادة

حالة شهادة طبقة المقابس الآمنة (SSL) لدى "استضافة التطبيقات" لاسم نطاقك. يمكن أن يمثل هذا إما حالة الشهادة الفعلية أو محاولة استضافة التطبيقات قيد التقدم لإنشاء شهادة بالنسبة إلى النطاقات المخصّصة الجديدة.

تعدادات
CERT_STATE_UNSPECIFIED حالة الشهادة غير محدّدة. تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك.
CERT_PREPARING تمثل الحالة الأولية لكل شهادة نية استضافة التطبيق في إنشاء شهادة قبل تقديم الطلبات إلى مرجع تصديق.
CERT_VALIDATING تتحقّق خدمة "استضافة التطبيق" مما إذا كانت سجلّات نظام أسماء النطاقات الخاصة باسم النطاق في حالة تسمح بإنشاء الشهادات نيابةً عنه.
CERT_PROPAGATING تم إنشاء الشهادة مؤخرًا، وتحتاج إلى بعض الوقت لنشرها في أجهزة موازنة حمل App Hosting.
CERT_ACTIVE الشهادة نشطة، وتوفر اتصالات آمنة لأسماء النطاقات التي تمثلها.
CERT_EXPIRING_SOON أوشكت الشهادة على الانتهاء، وسيتم منح جميع أسماء النطاقات المضمّنة فيها شهادات جديدة.
CERT_EXPIRED انتهت صلاحية الشهادة. لم يعد بإمكان استضافة التطبيقات عرض محتوى آمن على اسم نطاقك.

إشعارات نظام أسماء النطاقات

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

تمثيل JSON
{
  "domainName": string,
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": string
}
الحقول
domainName

string

النتائج فقط. اسم النطاق الذي ترتبط به تحديثات نظام أسماء النطاقات.

discovered[]

object (DnsRecordSet)

النتائج فقط. مجموعة من سجلات نظام أسماء النطاقات (DNS) خدمة "استضافة التطبيق" التي تم اكتشافها عند فحص أحد النطاقات.

desired[]

object (DnsRecordSet)

النتائج فقط. مجموعة سجلات نظام أسماء النطاقات التي تحتاجها خدمة "استضافة التطبيقات" للتمكن من عرض المحتوى الآمن على النطاق.

checkTime

string (Timestamp format)

النتائج فقط. آخر مرة راجعت فيها خدمة "استضافة التطبيقات" سجلات نظام أسماء النطاقات لنطاقك الخاص.

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

مجموعة DnsRecordSet

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

تمثيل JSON
{
  "domainName": string,
  "checkError": {
    object (Status)
  },
  "records": [
    {
      object (DnsRecord)
    }
  ]
}
الحقول
domainName

string

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

checkError

object (Status)

النتائج فقط. حدث خطأ أثناء إرسال طلب بحث في سجلّات نظام أسماء النطاقات لنطاقك. ملاحظة: تتجاهل استضافة التطبيق أخطاء NXDOMAIN، لأنّ هذه الأخطاء تعني عادةً أنّه لم يتم إعداد اسم النطاق إلى الآن.

records[]

object (DnsRecord)

النتائج فقط. السجلات على النطاق.

سجلّ نظام أسماء النطاقات

تمثيل لسجلّات نظام أسماء النطاقات لنطاق معيّن.

سجلّات نظام أسماء النطاقات هي سجلات للموارد تحدّد الإجراءات التي يجب أن تتصرف بها الأنظمة والخدمات عند التعامل مع الطلبات لأحد النطاقات. على سبيل المثال، عند إضافة سجلّات A إلى سجلّات نظام أسماء النطاقات لنطاقك، يعني ذلك أنّك تُعلِم الأنظمة الأخرى (مثل متصفّحات الويب لدى المستخدمين) بالتواصل مع عناوين IPv4 هذه لاسترداد الموارد ذات الصلة بنطاقك (مثل ملفات استضافة التطبيقات).

تمثيل JSON
{
  "domainName": string,
  "type": enum (Type),
  "rdata": string,
  "requiredAction": enum (Action),
  "relevantState": [
    enum (CustomDomainState)
  ]
}
الحقول
domainName

string

النتائج فقط. النطاق الذي يرتبط به السجل، على سبيل المثال foo.bar.com.

type

enum (Type)

النتائج فقط. نوع السجلّ الذي يحدّد البيانات التي يحتوي عليها السجلّ.

rdata

string

النتائج فقط. تمثّل هذه السمة البيانات في السجلّ. يعتمد معنى القيمة على نوع السجلّ: - A وAAAA: عنوان IP للنطاق. - CNAME: نطاق آخر للتحقق من السجلات. - TXT: سلاسل نصية عشوائية مرتبطة بالنطاق. تستخدم "استضافة التطبيقات" سجلّات TXT لتحديد مشاريع Firebase التي لديها الإذن بالتصرف نيابةً عن النطاق. - CAA: علامات السجل وعلاماته وقيمته، على سبيل المثال 0 issue "pki.goog"

requiredAction

enum (Action)

النتائج فقط. يشير ذلك المصطلح إلى تعداد يشير إلى الإجراء المطلوب لهذا السجلّ. تتم التعبئة عندما يكون السجلّ جزءًا من تغيير مطلوب في مجموعة سجلّات DnsUpdates discovered أو desired.

relevantState[]

enum (CustomDomainState)

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

النوع

نوع سجلّ نظام أسماء النطاقات، بما في ذلك A وTXT وAAAA وCAA.

تعدادات
TYPE_UNSPECIFIED نوع السجلّ غير محدّد. تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك.
A سجلّ A، على النحو المحدّد في RFC 1035 تحدد السجلات عناوين IPv4 التي يوجّه النطاق الزيارات إليها.
CNAME سجلّ CNAME، على النحو المحدّد في RFC 1035 تربط سجلّات CNAME أو "الاسم المتعارف عليه" نطاقًا بنطاق أساسي مختلف. في حال توفّر سجلّ CNAME، يجب أن يكون هذا هو السجلّ الوحيد على النطاق.
TXT سجلّ TXT، على النحو المحدّد في RFC 1035 تحتوي سجلّات TXT على بيانات نصية عشوائية في أحد النطاقات. تستخدم الاستضافة سجلّات TXT لتحديد مشروع Firebase الذي لديه الإذن بالتصرف على نطاق.
AAAA يحدّد سجلّ AAAA، كما هو محدّد في سجلّات AAAA في RFC 3596، عناوين IPv6 التي يوجّه النطاق الزيارات إليها.
CAA

سجلّ CAA، كما هو محدّد في RFC 6844. تحدد سجلات CAA أو تفويض مرجع التصديق، المراجع المصدقة (مؤسسات إصدار شهادات SSL) المسموح لها بإنشاء شهادة للنطاق. تستخدم استضافة التطبيقات pki.goog كمرجع تصديق أساسي لها.

سلسلة سجلات CAA. ينطبق سجلّ CAA على foo.com أيضًا على bar.foo.com ما لم يكن لدى bar.foo.com مجموعة خاصة من سجلّات CAA.

إنّ سجلات CAA اختيارية. في حال عدم توفُّر سجلّات CAA في النطاق ومصادره الرئيسية، يُسمح لجميع مراجع التصديق بإنشاء الشهادات نيابةً عنه. بشكل عام، تطلب منك "استضافة التطبيقات" تعديل سجلات CAA فقط عندما يكون ذلك مطلوبًا لإزالة حظر إنشاء شهادات طبقة المقابس الآمنة (SSL).

الإجراء

نوع الإجراء الذي يجب اتخاذه بشأن سجلّ نظام أسماء النطاقات هذا لضبط نطاقك لاستخدامه مع استضافة التطبيقات.

تعدادات
NONE ليس عليك اتّخاذ أي إجراء.
ADD أضِف هذا السجلّ إلى سجلّات نظام أسماء النطاقات.
REMOVE أزِل هذا السجلّ من سجلّات نظام أسماء النطاقات.

حالة النطاق المخصّص

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

تعدادات
CUSTOM_DOMAIN_STATE_UNSPECIFIED تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك.
HOST_STATE حالة مضيف النطاق المخصص.
OWNERSHIP_STATE حالة ملكية النطاق الخاص.
CERT_STATE حالة شهادة النطاق الخاص

الطُرق

create

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

delete

حذف نطاق واحد

get

يحصل على معلومات حول نطاق معيّن.

list

يسرد نطاقات الواجهة الخلفية.

patch

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