منبع: CustomDomain
CustomDomain
موجودیتی است که یک نام دامنه را به یک سایت میزبانی Firebase پیوند می دهد. یک CustomDomain
به سایت خود اضافه کنید تا به هاست اجازه دهید محتوای سایت را در پاسخ به درخواست هایی که علیه نام دامنه شما ارائه می شود ارائه دهد.
نمایندگی JSON |
---|
{ "name": string, "annotations": { string: string, ... }, "createTime": string, "updateTime": string, "deleteTime": string, "expireTime": string, "etag": string, "hostState": enum ( |
زمینه های | |
---|---|
name | فقط خروجی نام کاملاً واجد شرایط |
annotations | حاشیه نویسی هایی که می توانید اضافه کنید تا متادیتاهای قابل خواندن توسط انسان و ماشین در مورد یک شی حاوی لیستی از |
createTime | فقط خروجی زمان ایجاد دامنه سفارشی است. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
updateTime | فقط خروجی آخرین باری که مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
deleteTime | فقط خروجی زمانی که مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
expireTime | فقط خروجی حداقل زمان قبل از حذف کامل مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
etag | فقط خروجی رشته ای که وضعیت فعلی |
hostState | فقط خروجی |
ownershipState | فقط خروجی |
requiredDnsUpdates | فقط خروجی مجموعهای از بهروزرسانیهایی که باید در سوابق DNS نام دامنه انجام دهید تا به میزبانی اجازه دهید محتوای ایمن را از طرف خود ارائه دهد. |
issues[] | فقط خروجی مجموعه ای از خطاهایی که سیستم های هاست هنگام تلاش برای ایجاد قابلیت هاستینگ برای ارائه محتوای ایمن برای نام دامنه شما با آن مواجه می شوند. این مشکلات را حل کنید تا مطمئن شوید که |
certPreference | فیلدی که به شما امکان می دهد نوع گواهینامه SSL را که هاستینگ برای نام دامنه شما ایجاد می کند، مشخص کنید. دامنه های سفارشی طرح Spark فقط به نوع گواهی |
cert | فقط خروجی گواهی SSL Hosting برای نام دامنه این دامنه سفارشی دارد. برای دامنه های سفارشی جدید، این اغلب نشان دهنده قصد میزبانی برای ایجاد یک گواهی است، نه یک گواهی واقعی. برای اطلاعات بیشتر قسمت |
redirectTarget | نام دامنه ای که این |
reconciling | فقط خروجی فیلدی که اگر درست باشد، نشان میدهد که سیستمهای هاستینگ در تلاش هستند تا وضعیت دامنه سفارشی را با حالت دلخواه شما مطابقت دهند. این اغلب در هنگام ارائه اولیه یک |
labels | برچسبهایی که برای ابردادههای اضافی و/یا فیلتر کردن استفاده میشوند. یک شی حاوی لیستی از |
HostState
وضعیت میزبان نام دامنه شما. وضعیت میزبان با بررسی هر آدرس IP مرتبط با نام دامنه شما تعیین می شود تا ببینید آیا محتوای میزبانی را ارائه می دهد یا خیر.
Enums | |
---|---|
HOST_STATE_UNSPECIFIED | وضعیت میزبان دامنه سفارشی شما مشخص نشده است. اگر این پیام مشخص نشده باشد، نامعتبر است. |
HOST_UNHOSTED | نام دامنه دامنه سفارشی شما با هیچ آدرس IP مرتبط نیست. |
HOST_UNREACHABLE | نام دامنه دامنه سفارشی شما قابل دسترسی نیست. درخواستهای DNS سرویسهای میزبانی برای یافتن آدرسهای 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
شما بیش از 30 روز در OwnershipState
غیر از OWNERSHIP_ACTIVE
است و حداقل 30 روز است به روز نشده است، سیستم های مالکیت هاستینگ CustomDomain
را حذف می کنند. برای بازیابی یک CustomDomain
حذف شده، یک درخواست customDomains.undelete
انجام دهید.
Enums | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED | وضعیت مالکیت دامنه سفارشی شما مشخص نشده است. این هرگز نباید اتفاق بیفتد. |
OWNERSHIP_MISSING | نام دامنه سفارشی شما هیچ سابقه مالکیت مربوط به هاستینگ ندارد. هیچ پروژه Firebase اجازه فعالیت از طرف نام دامنه را ندارد. |
OWNERSHIP_UNREACHABLE | نام دامنه دامنه سفارشی شما قابل دسترسی نیست. جستجوهای DNS سرویس های میزبانی برای یافتن سوابق مالکیت نام دامنه شما منجر به خطا شد. برای جزئیات بیشتر به قسمت issues مربوط به شی CustomDomain خود مراجعه کنید. |
OWNERSHIP_MISMATCH | نام دامنه دامنه سفارشی شما متعلق به پروژه Firebase دیگری است. رکوردهای متناقض TXT حذف کنید و آنها را با رکوردهای خاص پروژه برای پروژه Firebase فعلی خود جایگزین کنید. |
OWNERSHIP_CONFLICT | نام دامنه دامنه سفارشی شما دارای سوابق TXT متناقضی است که نشان دهنده مالکیت پروژه فعلی Firebase شما و پروژه دیگری است. برای اعطای مالکیت پروژه فعلی، سوابق مالکیت پروژه دیگر را حذف کنید. |
OWNERSHIP_PENDING | رکوردهای DNS دامنه سفارشی شما به درستی پیکربندی شده است. هاست ظرف 24 ساعت مالکیت دامنه شما را به این CustomDomain منتقل می کند. |
OWNERSHIP_ACTIVE | نام دامنه سفارشی شما دارای سوابق TXT است که به پروژه اجازه می دهد تا از طرف آن اقدام کند. |
DnsUpdates
مجموعهای از بهروزرسانیهای رکورد DNS که باید انجام دهید تا به میزبانی اجازه دهید محتوای امنی را در پاسخ به درخواستها علیه نام دامنه شما ارائه کند. این بهروزرسانیها وضعیت فعلی سوابق DNS نام دامنه شما را زمانی که هاستینگ آخرین بار آنها را پرس و جو کرده است، و مجموعه مورد نظری از سوابق را که هاست باید قبل از اینکه دامنه سفارشی شما به طور کامل فعال شود، ببیند، نشان میدهد.
نمایندگی JSON |
---|
{ "discovered": [ { object ( |
زمینه های | |
---|---|
discovered[] | مجموعه ای از رکوردهای DNS میزبانی که هنگام بازرسی یک دامنه کشف می شود. |
desired[] | مجموعه رکوردهای DNS میزبان نیاز به ارائه محتوای امن در دامنه دارد. |
checkTime | آخرین باری که هاستینگ سوابق DNS دامنه سفارشی شما را بررسی کرد. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
DnsRecordSet
مجموعه ای از رکوردهای DNS مربوط به راه اندازی و نگهداری یک دامنه سفارشی در میزبانی Firebase.
نمایندگی JSON |
---|
{ "domainName": string, "checkError": { object ( |
زمینه های | |
---|---|
domainName | فقط خروجی نام دامنه ای که رکورد تنظیم شده به آن مربوط می شود. |
checkError | فقط خروجی خطایی در سرویس های میزبانی وب هنگام پرس و جو از سوابق DNS نام دامنه شما با آن مواجه شد. توجه: میزبانی خطاهای |
records[] | فقط خروجی سوابق در دامنه |
DnsRecord
رکوردهای DNS سوابق منابعی هستند که نحوه رفتار سیستم ها و سرویس ها را هنگام رسیدگی به درخواست ها برای نام دامنه تعریف می کنند. به عنوان مثال، وقتی رکوردهای A
را به رکوردهای DNS نام دامنه خود اضافه می کنید، به سیستم های دیگر (مانند مرورگرهای وب کاربران خود) اطلاع می دهید که با آن آدرس های IPv4 تماس بگیرند تا منابع مرتبط با نام دامنه شما (مانند فایل های سایت میزبانی شما) را بازیابی کنند. ).
نمایندگی JSON |
---|
{ "domainName": string, "type": enum ( |
زمینه های | |
---|---|
domainName | فقط خروجی نام دامنه ای که رکورد به آن مربوط می شود، به عنوان مثال |
type | فقط خروجی نوع رکورد، که تعیین می کند رکورد حاوی چه داده هایی است. |
rdata | فقط خروجی داده های رکورد. معنای مقدار به نوع رکورد بستگی دارد: - A و AAAA: آدرس های IP برای نام دامنه. - CNAME: دامنه دیگری برای بررسی سوابق. - TXT: رشته های متن دلخواه مرتبط با نام دامنه. هاستینگ از رکوردهای TXT برای تعیین اینکه کدام پروژه های Firebase مجوز فعالیت از طرف نام دامنه را دارند، استفاده می کند. - CAA: پرچمها، برچسب و مقدار رکورد، به عنوان مثال |
requiredAction | فقط خروجی یک عدد که نشان دهنده یک اقدام لازم برای این رکورد است. |
تایپ کنید
نوع رکورد DNS، از جمله A
، TXT
، AAAA
، و CAA
.
Enums | |
---|---|
TYPE_UNSPECIFIED | نوع رکورد مشخص نشده است. اگر این پیام مشخص نشده باشد، نامعتبر است. |
A | یک رکورد A ، همانطور که در RFC 1035 تعریف شده است. یک رکورد تعیین می کند که نام دامنه به کدام آدرس IPv4 ترافیک را هدایت می کند. |
CNAME | یک رکورد CNAME ، همانطور که در RFC 1035 تعریف شده است. رکوردهای CNAME یا Canonical Name یک نام دامنه را به یک نام دامنه متعارف دیگر نگاشت می کنند. اگر رکورد CNAME وجود داشته باشد، باید تنها رکورد روی نام دامنه باشد. |
TXT | یک رکورد TXT ، همانطور که در RFC 1035 تعریف شده است. رکوردهای TXT داده های متن دلخواه را روی نام دامنه نگه می دارند. میزبانی از سوابق TXT استفاده می کند تا مشخص کند کدام پروژه Firebase مجوز عمل بر روی نام دامنه را دارد. |
AAAA | یک رکورد AAAA، همانطور که در RFC 3596 سوابق AAAA تعریف شده است، تعیین می کند که نام دامنه ترافیک را به سمت کدام آدرس IPv6 هدایت می کند. |
CAA | یک رکورد CAA، همانطور که در RFC 6844 تعریف شده است. CAA یا مجوز مرجع صدور گواهی، سوابق تعیین می کند که کدام مقامات صدور گواهی (سازمان های تولید گواهی SSL) مجاز به صدور گواهی برای نام دامنه هستند. میزبانی Firebase از آبشار سوابق CAA. یک رکورد CAA در سوابق CAA اختیاری هستند. اگر یک نام دامنه و والدین آن هیچ سوابق CAA نداشته باشند، همه CA مجاز به صدور گواهینامه از طرف آن هستند. به طور کلی، میزبانی فقط از شما می خواهد که سوابق CAA را تغییر دهید، زمانی که انجام این کار برای رفع انسداد ایجاد گواهی SSL لازم است. |
عمل
Action نوعی اقدام است که باید روی این رکورد DNS انجام دهید تا دامنه خود را برای استفاده با میزبانی Firebase پیکربندی کنید.
Enums | |
---|---|
NONE | هیچ اقدامی لازم نیست |
ADD | این رکورد را به رکوردهای DNS خود اضافه کنید. |
REMOVE | این رکورد را از رکوردهای DNS خود حذف کنید. |
تایپ کنید
نوع گواهی تعیین می کند که سیستم های میزبانی چگونه گواهی را ایجاد و نگهداری می کنند.
Enums | |
---|---|
TYPE_UNSPECIFIED | نوع گواهی نامشخص است. اگر این پیام مشخص نشده باشد، نامعتبر است. |
TEMPORARY | یک نوع گواهی کوتاه مدت که نام دامنه را به طور موقت پوشش می دهد، در حالی که میزبانی یک گواهی دائمی تر ایجاد می کند. |
GROUPED | گواهی استاندارد برای دامنه های سفارشی طرح Spark. |
PROJECT_GROUPED | فقط طرح بلیز گواهینامه ای که از 1 تا 100 نام دامنه با دامنه های سفارشی در همان پروژه Firebase را پوشش می دهد. |
DEDICATED | فقط طرح بلیز گواهینامه ای که یک نام دامنه را پوشش می دهد. |
گواهی
یک گواهی SSL که برای ارائه رمزگذاری سرتاسر برای درخواستهای نام دامنه شما استفاده میشود. یک Certificate
می تواند یک گواهی واقعی SSL یا برای دامنه های سفارشی تازه ایجاد شده، قصد میزبانی برای ایجاد یک گواهی باشد.
نمایندگی JSON |
---|
{ "type": enum ( |
زمینه های | |
---|---|
type | فقط خروجی نوع گواهی |
state | فقط خروجی وضعیت گواهی. فقط حالتهای |
verification | فقط خروجی مجموعهای از چالشهای ACME را که میتوانید به سوابق DNS یا ارائهدهنده هاست موجود و غیر میزبان اضافه کنید تا به هاستینگ اجازه دهید قبل از اینکه ترافیک را به سمت میزبانی هدایت کنید، یک گواهی SSL برای نام دامنه شما ایجاد کند. میتوانید از این چالشها به عنوان بخشی از انتقال بدون توقف از ارائهدهنده قدیمی خود به میزبانی استفاده کنید. |
issues[] | فقط خروجی مجموعه ای از خطاهایی که هاست هنگام تلاش برای ایجاد یک گواهی برای نام دامنه شما با آن مواجه شده است. این مشکلات را حل کنید تا اطمینان حاصل شود که هاست قادر به برقراری ارتباط امن با بازدیدکنندگان سایت شما است. |
createTime | فقط خروجی زمان ایجاد گواهی برای گواهینامه های مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
expireTime | فقط خروجی زمان انقضای گواهینامه پس از این مدت، گواهی دیگر نمی تواند برای برقراری ارتباط امن بین هاستینگ و بازدیدکنندگان سایت شما استفاده شود. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
CertState
وضعیت گواهی SSL که هاست برای نام دامنه شما دارد. این می تواند نشان دهنده وضعیت گواهی واقعی باشد یا برای دامنه های سفارشی جدید، تلاش هاستینگ برای ایجاد یک گواهی.
Enums | |
---|---|
CERT_STATE_UNSPECIFIED | وضعیت گواهی نامشخص است. اگر این پیام مشخص نشده باشد، نامعتبر است. |
CERT_PREPARING | وضعیت اولیه هر گواهی، نشان دهنده قصد میزبانی برای ایجاد یک گواهی، قبل از درخواست به یک مرجع صدور گواهی است. |
CERT_VALIDATING | میزبانی در حال تایید است که آیا سوابق DNS نام دامنه در حالتی هستند که اجازه ایجاد گواهی از طرف آن را می دهد یا خیر. |
CERT_PROPAGATING | گواهی اخیرا ایجاد شده است و برای انتشار در CDN هاستینگ به زمان نیاز دارد. |
CERT_ACTIVE | این گواهی فعال است و اتصالات امنی را برای نام های دامنه ای که نشان می دهد فراهم می کند. |
CERT_EXPIRING_SOON | گواهی در حال منقضی شدن است، به همه نامهای دامنه روی آن گواهیهای جدید داده میشود. |
CERT_EXPIRED | گواهی منقضی شده است. هاست دیگر نمی تواند محتوای ایمن را در نام دامنه شما ارائه دهد. |
CertVerification
مجموعهای از چالشهای ACME که میتوانید از آنها برای اجازه دادن به هاستینگ برای ایجاد گواهی SSL برای نام دامنه شما قبل از هدایت ترافیک به سرورهای میزبان استفاده کنید. از چالش DNS یا HTTP استفاده کنید. ارائه هر دو لازم نیست.
نمایندگی JSON |
---|
{ "dns": { object ( |
زمینه های | |
---|---|
dns | فقط خروجی یک رکورد |
http | فقط خروجی فایلی برای افزودن به سرویس هاست موجود و غیر هاستینگ خود که قصد شما را برای اجازه دادن به هاستینگ برای ایجاد یک گواهی SSL برای نام دامنه شما تایید می کند. |
HttpUpdate
فایلی که میتوانید به سرویس میزبانی موجود و غیر میزبان خود اضافه کنید که قصد شما را برای اجازه دادن به مقامات صدور گواهی میزبانی برای ایجاد یک گواهی SSL برای دامنه شما تأیید میکند.
نمایندگی JSON |
---|
{
"path": string,
"desired": string,
"discovered": string,
"lastCheckTime": string,
"checkError": {
object ( |
زمینه های | |
---|---|
path | فقط خروجی مسیر فایل. |
desired | فقط خروجی یک رشته متن برای خدمت در مسیر. |
discovered | فقط خروجی آیا هاستینگ توانسته است محتوای فایل مورد نیاز را در مسیر مشخص شده در آخرین بررسی خود پیدا کند یا خیر. |
lastCheckTime | فقط خروجی آخرین باری که سیستم های میزبانی محتوای فایل را بررسی کردند. مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثالها: |
checkError | فقط خروجی خطایی در آخرین بررسی محتویات رخ داد. در صورت تهی بودن، بررسی با موفقیت انجام شد. |
مواد و روش ها | |
---|---|
| یک CustomDomain ایجاد می کند. |
| CustomDomain مشخص شده را حذف می کند. |
| CustomDomain مشخص شده را دریافت می کند. |
| هر CustomDomain مرتبط با سایت میزبانی والدین مشخص شده را فهرست می کند. |
| CustomDomain مشخص شده را به روز می کند. |
| در صورتی که CustomDomain مشخص شده به صورت نرم حذف شده باشد، حذف می شود. |