REST Resource: projects.sites.customDomains

المورد: CustomDomain

CustomDomain هو كيان يربط اسم نطاق بموقع استضافة Firebase. يمكنك إضافة CustomDomain إلى موقعك الإلكتروني للسماح للاستضافة بعرض محتوى الموقع الإلكتروني استجابةً للطلبات الصادرة عن اسم نطاقك.

تمثيل JSON 
{
  "name": string,
  "annotations": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "etag": string,
  "hostState": enum (HostState),
  "ownershipState": enum (OwnershipState),
  "requiredDnsUpdates": {
    object (DnsUpdates)
  },
  "issues": [
    {
      object (Status)
    }
  ],
  "certPreference": enum (Type),
  "cert": {
    object (Certificate)
  },
  "redirectTarget": string,
  "reconciling": boolean,
  "labels": {
    string: string,
    ...
  }
}
الحقول
name

string

النتائج فقط. تمثّل هذه السمة اسم CustomDomain المؤهّل بالكامل.
annotations

map (key: string, value: string)

التعليقات التوضيحية التي يمكنك إضافتها لترك بيانات وصفية حول CustomDomain يمكن للمستخدمين قراءتها

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
createTime

string (Timestamp format)

النتائج فقط. وقت إنشاء النطاق الخاص

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

string (Timestamp format)

النتائج فقط. تاريخ آخر تحديث لـ CustomDomain

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

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه حذف CustomDomain فارغ للنطاقات المخصصة التي لم يتم حذفها. تستمر النطاقات المخصصة المحذوفة لمدة 30 يومًا تقريبًا، وبعد هذه الفترة تزيلها الاستضافة تمامًا. لاستعادة نطاق خاص محذوف، يمكنك تقديم طلب customDomains.undelete.

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

string (Timestamp format)

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

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

string

النتائج فقط. سلسلة تمثّل الحالة الحالية لـ CustomDomain وتسمح لك بتأكيد حالتها الأولية في الطلبات التي قد تعدّلها. استخدِم العلامة لضمان الاتساق عند تقديم طلبات customDomains.patch وcustomDomains.delete وcustomDomains.undelete.
hostState

enum (HostState)

النتائج فقط. HostState لاسم النطاق الذي يشير إليه هذا العمود CustomDomain.
ownershipState

enum (OwnershipState)

النتائج فقط. OwnershipState لاسم النطاق الذي يشير إليه هذا العمود CustomDomain.
requiredDnsUpdates

object (DnsUpdates)

النتائج فقط. هي مجموعة من التعديلات التي يجب إجراؤها على سجلّات نظام أسماء النطاقات الخاصة باسم النطاق للسماح للاستضافة بعرض محتوى آمن نيابةً عنها.
issues[]

object (Status)

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

enum (Type)

حقل يتيح لك تحديد نوع شهادة طبقة المقابس الآمنة (SSL) التي تنشئها الاستضافة لاسم نطاقك. يمكن للنطاقات الخاصة لخطة البداية والنهاية فقط الوصول إلى نوع شهادة GROUPED، في حين يمكن لنطاقات خطة Blaze تحديد أي خيار.
cert

object (Certificate)

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

string

اسم نطاق يجب أن يوجّه CustomDomain الزيارات إليه. وفي حال تحديد ذلك، ستستجيب الاستضافة للطلبات في هذا النطاق الخاص باستخدام رمز HTTP 301، وتوجّه الزيارات إلى redirectTarget المحدَّد بدلاً من ذلك.
reconciling

boolean

النتائج فقط. حقل، في حال كان هذا الحقل صحيحًا، يشير إلى أنّ أنظمة الاستضافة تستوعب هذه السياسة لجعل حالة النطاق الخاص مطابقة لحالتك المفضّلة. يحدث هذا في أغلب الأحيان true عند توفير CustomDomain في البداية بعد طلب customDomains.create أو عند إنشاء شهادة طبقة مقابس آمنة جديدة لمطابقة certPreference محدّث بعد طلب customDomains.patch.
labels

map (key: string, value: string)

التصنيفات المستخدمة لإضافة بيانات وصفية و/أو فلترة إضافية.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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

حالة المضيف لاسم نطاقك. يتم تحديد حالة المضيف من خلال التحقّق من كل عنوان IP مرتبط باسم نطاقك لمعرفة ما إذا كان يعرض محتوى مستضافًا.

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

حالة الملكية

حالة ملكية نطاقك. يمكن أن يكون النطاق مملوكًا من قِبل موقع استضافة Firebase واحد على الأكثر. يمكن تحديد الملكية بطريقتين:

* TXT records: A TXT record on the domain in the form
`hosting-site=[siteId]`.
* CNAME records: A CNAME record that points to a Hosting site's default
domain.

إذا كان CustomDomain في OwnershipState بخلاف OWNERSHIP_ACTIVE لمدة تزيد عن 30 يومًا ولم يتم تعديله خلال 30 يومًا على الأقل، ستحذف أنظمة ملكية الاستضافة CustomDomain. لاستعادة CustomDomain محذوف، عليك تقديم طلب customDomains.undelete.

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

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

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

تمثيل JSON 
{
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": 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

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

تمثيل 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)
}
الحقول
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)

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

النوع

نوع سجلّ نظام أسماء النطاقات، بما في ذلك 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) المسموح لها بإنشاء شهادة لاسم النطاق. تستخدم استضافة Firebase Hosting pki.goog كمرجع تصديق أساسي لها.

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

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

الإجراء

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

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

النوع

نوع الشهادة. يحدِّد هذا الإعداد كيفية تعامل أنظمة الاستضافة مع عملية إنشاء الشهادة والحفاظ عليها.

تعدادات
TYPE_UNSPECIFIED نوع الشهادة غير محدد. تكون هذه الرسالة غير صالحة إذا لم يتم تحديد ذلك.
TEMPORARY نوع شهادة قصير الأجل يغطي اسم نطاق مؤقتًا، بينما تنشئ خدمة الاستضافة شهادة دائمة أكثر.
GROUPED الشهادة العادية للنطاقات الخاصة لخطة Spark.
PROJECT_GROUPED خطة Blaze فقط شهادة تغطي من اسم نطاق واحد إلى 100 اسم نطاق مع نطاقات خاصة في مشروع Firebase نفسه
DEDICATED خطة Blaze فقط شهادة تغطّي اسم نطاق واحدًا.

شهادة

يشير هذا المصطلح إلى شهادة طبقة المقابس الآمنة (SSL) تُستخدَم لتوفير تشفير تام بين الأطراف للطلبات الواردة إلى اسم نطاقك. يمكن أن تكون Certificate شهادة طبقة مقابس آمنة (SSL) فعلية أو رغبة الاستضافة في إنشاء شهادة للنطاقات المخصصة التي تم إنشاؤها حديثًا.

تمثيل JSON 
{
  "type": enum (Type),
  "state": enum (CertState),
  "verification": {
    object (CertVerification)
  },
  "issues": [
    {
      object (Status)
    }
  ],
  "createTime": string,
  "expireTime": string
}
الحقول
type

enum (Type)

النتائج فقط. نوع الشهادة.
state

enum (CertState)

النتائج فقط. حالة الشهادة. توفِّر الحالتان CERT_ACTIVE وCERT_EXPIRING_SOON فقط تغطية طبقة المقابس الآمنة لاسم النطاق. إذا كانت الحالة هي PROPAGATING وكان للاستضافة شهادة نشطة لاسم النطاق من قبل، ستوفّر هذه الشهادة النشطة سابقًا تغطية طبقة المقابس الآمنة لاسم النطاق إلى أن يتم نشر الشهادة الحالية.
verification

object (CertVerification)

النتائج فقط. مجموعة من اختبارات ACME التي يمكنك إضافتها إلى سجلّات نظام أسماء النطاقات أو المستضيف الحالي غير المضيف للسماح للاستضافة بإنشاء شهادة طبقة المقابس الآمنة (SSL) لاسم نطاقك قبل توجيه الزيارات نحو الاستضافة. يمكنك استخدام هذه التحديات كجزء من عملية الانتقال من مزوّد الخدمة القديم إلى خدمة الاستضافة بدون أي انقطاع.
issues[]

object (Status)

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

حالة الشهادة

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

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

التحقّق من الشهادة

مجموعة من اختبارات ACME التي يمكنك استخدامها للسماح للاستضافة بإنشاء شهادة طبقة المقابس الآمنة (SSL) لاسم نطاقك قبل توجيه الزيارات إلى خوادم الاستضافة. استخدِم إما اختبار نظام أسماء النطاقات أو اختبار HTTP. ليس من الضروري تقديم كليهما.

تمثيل JSON 
{
  "dns": {
    object (DnsUpdates)
  },
  "http": {
    object (HttpUpdate)
  }
}
الحقول
dns

object (DnsUpdates)

النتائج فقط. سجلّ TXT لإضافته إلى سجلّات نظام أسماء النطاقات يؤكّد رغبتك في السماح للاستضافة بإنشاء شهادة طبقة المقابس الآمنة (SSL) لاسم نطاقك.
http

object (HttpUpdate)

النتائج فقط. ملف لإضافته إلى خدمة الاستضافة الحالية وغير المضيفة يؤكّد رغبتك في السماح للاستضافة بإنشاء شهادة طبقة المقابس الآمنة (SSL) لاسم نطاقك

تحديث Http

ملف يمكنك إضافته إلى خدمة الاستضافة الحالية غير المضيفة يؤكد رغبتك في السماح للمراجع المصدقة للاستضافة بإنشاء شهادة طبقة المقابس الآمنة (SSL) لنطاقك.

تمثيل JSON 
{
  "path": string,
  "desired": string,
  "discovered": string,
  "lastCheckTime": string,
  "checkError": {
    object (Status)
  }
}
الحقول
path

string

النتائج فقط. المسار إلى الملف.
desired

string

النتائج فقط. سلسلة نصية لعرضها في المسار.
discovered

string

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

string (Timestamp format)

النتائج فقط. آخر مرة تتحقّق فيها أنظمة الاستضافة من محتوى الملف.

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

object (Status)

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

الطُرق

create

 ينشئ CustomDomain.

delete

 يؤدي هذا الإجراء إلى حذف قيمة CustomDomain المحدّدة.

get

 للحصول على قيمة CustomDomain المحدّدة

list

 يسرد كل CustomDomain مرتبط بموقع الاستضافة الإلكتروني الرئيسي المحدّد.

patch

 تعمل هذه السياسة على تعديل قيمة CustomDomain المحدّدة.

undelete

 لإلغاء حذف CustomDomain المحددة إذا تم حذفه مبدئيًا.