المورد: النطاق
يشير ذلك المصطلح إلى اسم نطاق مرتبط بواجهة خلفية.
تمثيل JSON |
---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string, "type": enum ( |
الحقول | |
---|---|
name |
المُعرّف. اسم مورد النطاق، على سبيل المثال |
displayName |
هذه السمة اختيارية. اسم النطاق قابل للتغيير ويمكن لشخص عادي قراءته عدد الأحرف المسموح به هو 63 حرفًا مثلاً: |
createTime |
النتائج فقط. وقت إنشاء النطاق طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
النتائج فقط. وقت آخر تعديل للنطاق طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
type |
النتائج فقط. نوع النطاق. |
disabled |
هذه السمة اختيارية. ما إذا كان النطاق غير مفعَّل. وتكون القيمة التلقائية على "خطأ". |
serve |
هذه السمة اختيارية. طريقة عرض النطاق وفي حال تحديد هذا الخيار، سيعرض النطاق محتوى آخر غير المحتوى المباشر لواجهته الخلفية. |
customDomainStatus |
النتائج فقط. يمثل ذلك حالة النطاق من النوع |
reconciling |
النتائج فقط. يشير ذلك المصطلح، إذا كانت القيمة إلى "صحيح"، إلى أنّ الإصدار يتضمّن مهمة LRO جارية. |
deleteTime |
النتائج فقط. وقت حذف النطاق. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
purgeTime |
النتائج فقط. الوقت الذي تتم فيه الإزالة النهائية لنطاق محذوف مبدئيًا، ويتم عرضه نهائيًا طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
labels |
هذه السمة اختيارية. التصنيفات كأزواج قيم رئيسية. عنصر يحتوي على قائمة بأزواج |
annotations |
هذه السمة اختيارية. التعليقات التوضيحية كأزواج قيم رئيسية عنصر يحتوي على قائمة بأزواج |
uid |
النتائج فقط. معرّف فريد يحدّده النظام |
etag |
النتائج فقط. المجموع الاختباري الذي احتسبه الخادم استنادًا إلى قيم أخرى عند التحديث أو الحذف لضمان إتمام العملية في المورد المتوقع. |
النوع
نوع النطاق.
تعدادات | |
---|---|
TYPE_UNSPECIFIED |
النوع غير محدد (لا ينبغي أن يحدث هذا). |
DEFAULT |
النطاقات التلقائية، سواء كانت متاحة أو مُدارة من خلال "استضافة التطبيقات". يتم إنشاء هذه النطاقات تلقائيًا باستخدام الواجهة الخلفية لها ولا يمكن حذفها إلا من خلال حذف ذلك النطاق الرئيسي، ولا يمكن نقلها إلى واجهة خلفية أخرى. يمكن إيقاف النطاقات التلقائية من خلال الحقل disabled . |
CUSTOM |
النطاقات المخصَّصة التي يملكها المطوِّر تتيح لك النطاقات المخصَّصة ربط نطاق تملكه بواجهة استضافة التطبيقات، وإعداد هذا النطاق لعرض محتوى الخلفية. |
سلوك العرض
يشير إلى ما إذا كانت استضافة التطبيق ستعرض المحتوى على النطاق.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد serving_behavior . يؤدي تحديد هذا الخيار إلى تخصيص سلوك عرض النطاق. يمكن أن يكون serving_behavior واحدًا فقط مما يلي: |
|
redirect |
هذه السمة اختيارية. سلوك إعادة التوجيه لأحد النطاقات، إذا تم توفيره. |
إعادة توجيه
تحدِّد هذه السياسة سلوك إعادة التوجيه لنطاق معيّن.
تمثيل JSON |
---|
{ "uri": string, "status": string } |
الحقول | |
---|---|
uri |
مطلوب. معرّف الموارد المنتظم (URI) لوجهة إعادة التوجيه. ستتم إضافة معرّف الموارد المنتظم (URI) هذا إلى مسار الطلب الأصلي. يُفترض أن يكون معرف الموارد المنتظم (URI) بدون مخطط هو HTTPS. |
status |
هذه السمة اختيارية. رمز الحالة المطلوب استخدامه في استجابة إعادة التوجيه. يجب أن يكون رمز حالة HTTP 3XX صالحًا. وتكون القيم التلقائية 302 في حال عدم توفّرها. |
حالة النطاق المخصص
حالة ربط نطاق خاص بواجهة خلفية.
تمثيل JSON |
---|
{ "hostState": enum ( |
الحقول | |
---|---|
hostState |
النتائج فقط. لتتبُّع ما إذا كان قد تم رصد نطاق خاص على أنه يوجّه الزيارات بشكلٍ مناسب إلى "استضافة التطبيقات". |
ownershipState |
النتائج فقط. لتتبُّع ما إذا كان مسموحًا للواجهة الخلفية بعرض المحتوى على النطاق، استنادًا إلى سجلّات نظام أسماء النطاقات للنطاق |
certState |
النتائج فقط. لتتبُّع حالة شهادة طبقة المقابس الآمنة (SSL) للنطاق |
requiredDnsUpdates[] |
النتائج فقط. يسرد السجلات التي يجب إضافتها أو إزالتها إلى نظام أسماء النطاقات لنطاق خاص لإنهاء الإعداد والبدء في عرض المحتوى. يتوفّر الحقل أثناء عملية الإعداد. يتوفر أيضًا بعد الإعداد في حال لم تكن واحدة أو أكثر من الحالات المذكورة أعلاه *_ACTIVE، مما يشير إلى أن سجلات نظام أسماء النطاقات للنطاق في حالة سيئة. |
issues[] |
النتائج فقط. قائمة بالمشاكل المتعلقة بضبط النطاق. يسمح هذا الإعداد للمستخدمين بتصحيح المشاكل في سجلّات نظام أسماء النطاقات بأنفسهم. |
حالة المضيف (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 ( |
الحقول | |
---|---|
domainName |
النتائج فقط. اسم النطاق الذي ترتبط به تحديثات نظام أسماء النطاقات. |
discovered[] |
النتائج فقط. مجموعة من سجلات نظام أسماء النطاقات (DNS) خدمة "استضافة التطبيق" التي تم اكتشافها عند فحص أحد النطاقات. |
desired[] |
النتائج فقط. مجموعة سجلات نظام أسماء النطاقات التي تحتاجها خدمة "استضافة التطبيقات" للتمكن من عرض المحتوى الآمن على النطاق. |
checkTime |
النتائج فقط. آخر مرة راجعت فيها خدمة "استضافة التطبيقات" سجلات نظام أسماء النطاقات لنطاقك الخاص. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
مجموعة DnsRecordSet
يشير ذلك المصطلح إلى مجموعة من سجلّات نظام أسماء النطاقات ذات الصلة بإعداد نطاق خاص وصيانته في "استضافة التطبيقات".
تمثيل JSON |
---|
{ "domainName": string, "checkError": { object ( |
الحقول | |
---|---|
domainName |
النتائج فقط. اسم النطاق الذي ترتبط به مجموعة السجلات. |
checkError |
النتائج فقط. حدث خطأ أثناء إرسال طلب بحث في سجلّات نظام أسماء النطاقات لنطاقك. ملاحظة: تتجاهل استضافة التطبيق أخطاء |
records[] |
النتائج فقط. السجلات على النطاق. |
سجلّ نظام أسماء النطاقات
تمثيل لسجلّات نظام أسماء النطاقات لنطاق معيّن.
سجلّات نظام أسماء النطاقات هي سجلات للموارد تحدّد الإجراءات التي يجب أن تتصرف بها الأنظمة والخدمات عند التعامل مع الطلبات لأحد النطاقات. على سبيل المثال، عند إضافة سجلّات A
إلى سجلّات نظام أسماء النطاقات لنطاقك، يعني ذلك أنّك تُعلِم الأنظمة الأخرى (مثل متصفّحات الويب لدى المستخدمين) بالتواصل مع عناوين IPv4 هذه لاسترداد الموارد ذات الصلة بنطاقك (مثل ملفات استضافة التطبيقات).
تمثيل JSON |
---|
{ "domainName": string, "type": enum ( |
الحقول | |
---|---|
domainName |
النتائج فقط. النطاق الذي يرتبط به السجل، على سبيل المثال |
type |
النتائج فقط. نوع السجلّ الذي يحدّد البيانات التي يحتوي عليها السجلّ. |
rdata |
النتائج فقط. تمثّل هذه السمة البيانات في السجلّ. يعتمد معنى القيمة على نوع السجلّ: - A وAAAA: عنوان IP للنطاق. - CNAME: نطاق آخر للتحقق من السجلات. - TXT: سلاسل نصية عشوائية مرتبطة بالنطاق. تستخدم "استضافة التطبيقات" سجلّات TXT لتحديد مشاريع Firebase التي لديها الإذن بالتصرف نيابةً عن النطاق. - CAA: علامات السجل وعلاماته وقيمته، على سبيل المثال |
requiredAction |
النتائج فقط. يشير ذلك المصطلح إلى تعداد يشير إلى الإجراء المطلوب لهذا السجلّ. تتم التعبئة عندما يكون السجلّ جزءًا من تغيير مطلوب في مجموعة سجلّات |
relevantState[] |
النتائج فقط. تعداد يشير إلى الحالات التي ينطبق عليها سجلّ نظام أسماء النطاقات هذا تتم تعبئة جميع السجلات باستخدام إجراء مطلوب |
النوع
نوع سجلّ نظام أسماء النطاقات، بما في ذلك 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) المسموح لها بإنشاء شهادة للنطاق. تستخدم استضافة التطبيقات سلسلة سجلات CAA. ينطبق سجلّ CAA على إنّ سجلات CAA اختيارية. في حال عدم توفُّر سجلّات CAA في النطاق ومصادره الرئيسية، يُسمح لجميع مراجع التصديق بإنشاء الشهادات نيابةً عنه. بشكل عام، تطلب منك "استضافة التطبيقات" تعديل سجلات CAA فقط عندما يكون ذلك مطلوبًا لإزالة حظر إنشاء شهادات طبقة المقابس الآمنة (SSL). |
الإجراء
نوع الإجراء الذي يجب اتخاذه بشأن سجلّ نظام أسماء النطاقات هذا لضبط نطاقك لاستخدامه مع استضافة التطبيقات.
تعدادات | |
---|---|
NONE |
ليس عليك اتّخاذ أي إجراء. |
ADD |
أضِف هذا السجلّ إلى سجلّات نظام أسماء النطاقات. |
REMOVE |
أزِل هذا السجلّ من سجلّات نظام أسماء النطاقات. |
حالة النطاق المخصّص
يشير ذلك المصطلح إلى مجموعة من الحالات ذات الصلة بالأداء الصحيح لنطاق خاص.
تعدادات | |
---|---|
CUSTOM_DOMAIN_STATE_UNSPECIFIED |
تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك. |
HOST_STATE |
حالة مضيف النطاق المخصص. |
OWNERSHIP_STATE |
حالة ملكية النطاق الخاص. |
CERT_STATE |
حالة شهادة النطاق الخاص |
الطُرق |
|
---|---|
|
يربط نطاقًا جديدًا بواجهة خلفية. |
|
حذف نطاق واحد |
|
يحصل على معلومات حول نطاق معيّن. |
|
يسرد نطاقات الواجهة الخلفية. |
|
لتعديل معلومات نطاق واحد. |