ทรัพยากร: โดเมน
ชื่อโดเมนที่เชื่อมโยงกับแบ็กเอนด์
การแสดง JSON |
---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string, "type": enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อทรัพยากรของโดเมน เช่น |
displayName |
ไม่บังคับ ชื่อที่มนุษย์อ่านได้สำหรับโดเมน จำนวนอักขระสูงสุด 63 ตัว เช่น |
createTime |
เอาต์พุตเท่านั้น เวลาที่สร้างโดเมน การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
updateTime |
เอาต์พุตเท่านั้น เวลาที่อัปเดตโดเมนครั้งล่าสุด การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
type |
เอาต์พุตเท่านั้น ประเภทของโดเมน |
disabled |
ไม่บังคับ มีการปิดใช้งานโดเมนหรือไม่ ค่าเริ่มต้นคือ "เท็จ" |
serve |
ไม่บังคับ ลักษณะการแสดงผลของโดเมน หากระบุ โดเมนจะแสดงเนื้อหาอื่นนอกเหนือจากเนื้อหาสดของแบ็กเอนด์ |
customDomainStatus |
เอาต์พุตเท่านั้น แสดงสถานะและการกำหนดค่าของโดเมนประเภท |
reconciling |
เอาต์พุตเท่านั้น ฟิลด์ที่หากเป็น "จริง" แสดงว่าบิลด์มี LRO ต่อเนื่อง |
deleteTime |
เอาต์พุตเท่านั้น เวลาที่โดเมนถูกลบ การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
purgeTime |
เอาต์พุตเท่านั้น เวลาที่โดเมนที่ลบแบบชั่วคราวจะถูกลบถาวร โดยการแสดงผลจะถูกลบอย่างถาวร การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
labels |
ไม่บังคับ ติดป้ายกำกับเป็นคู่คีย์-ค่า ออบเจ็กต์ที่มีรายการคู่ |
annotations |
ไม่บังคับ คำอธิบายประกอบเป็นคู่คีย์-ค่า ออบเจ็กต์ที่มีรายการคู่ |
uid |
เอาต์พุตเท่านั้น ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดโดยระบบ |
etag |
เอาต์พุตเท่านั้น การตรวจสอบข้อผิดพลาดที่ประมวลผลโดยเซิร์ฟเวอร์โดยอิงตามค่าอื่นๆ อาจส่งเมื่อมีการอัปเดตหรือลบเพื่อดูแลให้ทรัพยากรที่คาดหวังทำงานได้ |
ประเภท
ประเภทของโดเมน
Enum | |
---|---|
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 หากไม่มี |
CustomDomainStatus
สถานะของการลิงก์ของโดเมนที่กำหนดเองกับแบ็กเอนด์
การแสดง JSON |
---|
{ "hostState": enum ( |
ช่อง | |
---|---|
hostState |
เอาต์พุตเท่านั้น ติดตามว่ามีการตรวจพบว่าโดเมนที่กำหนดเองมีการเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังโฮสติ้งแอปอย่างเหมาะสมหรือไม่ |
ownershipState |
เอาต์พุตเท่านั้น ติดตามว่าแบ็กเอนด์ได้รับอนุญาตให้แสดงเนื้อหาในโดเมนหรือไม่ โดยอิงตามระเบียน DNS ของโดเมน |
certState |
เอาต์พุตเท่านั้น ติดตามสถานะใบรับรอง SSL สำหรับโดเมน |
requiredDnsUpdates[] |
เอาต์พุตเท่านั้น แสดงรายการระเบียนที่ต้องเพิ่มหรือนำออกจาก DNS ของโดเมนที่กำหนดเองเพื่อให้การตั้งค่าเสร็จสมบูรณ์และเริ่มแสดงเนื้อหา มีการแสดงช่องนี้ในระหว่างการเริ่มต้นใช้งาน จะปรากฏหลังการเริ่มต้นใช้งานด้วยหากมีสถานะข้างต้นอย่างน้อย 1 รายการไม่ใช่ *_ACTIVE แสดงว่าระเบียน DNS ของโดเมนอยู่ในสถานะที่ไม่ถูกต้อง |
issues[] |
เอาต์พุตเท่านั้น รายการปัญหาเกี่ยวกับการกำหนดค่าโดเมน อนุญาตให้ผู้ใช้แก้ไขปัญหาเกี่ยวกับระเบียน DNS ด้วยตนเอง |
สถานะโฮสต์
สถานะโฮสต์ของโดเมน ระบบจะกำหนดสถานะโฮสต์โดยการตรวจสอบที่อยู่ IP แต่ละรายการที่เชื่อมโยงกับโดเมนของคุณเพื่อดูว่าแสดงผ่านชาร์ดที่เหมาะสมของต้นทางโฮสติ้งของแอปหรือไม่
Enum | |
---|---|
HOST_STATE_UNSPECIFIED |
ยังไม่ได้ระบุสถานะโฮสต์ของโดเมนที่กำหนดเอง ข้อความไม่ถูกต้องหากไม่ได้ระบุ |
HOST_UNHOSTED |
โดเมนที่กำหนดเองของคุณไม่ได้เชื่อมโยงกับที่อยู่ IP ใดๆ |
HOST_UNREACHABLE |
เข้าถึงโดเมนที่กำหนดเองไม่ได้ บริการโฮสติ้งแอป" ส่งผลให้เกิดข้อผิดพลาด DNS เพื่อค้นหาที่อยู่ IP ของโดเมน ดูรายละเอียดเพิ่มเติมในช่อง issues ของ CustomDomainStatus |
HOST_NON_FAH |
โดเมนของคุณมีเพียงที่อยู่ IP ที่ไม่สามารถแปลงเป็นโฮสติ้งแอปได้ |
HOST_CONFLICT |
โดเมนของคุณมีที่อยู่ IP ที่ตรงกับทั้งโฮสติ้งแอปและบริการอื่นๆ โปรดนำระเบียน A และ AAAA ที่เกี่ยวข้องกับบริการที่ไม่ใช่โฮสติ้งแอปออกเพื่อให้ได้ผลลัพธ์ที่สอดคล้องกัน |
HOST_WRONG_SHARD |
โดเมนของคุณมีที่อยู่ IP ที่แก้ไขเป็นภูมิภาคและ/หรือชาร์ดการจำลองของโฮสติ้งแอปไม่ถูกต้อง |
HOST_ACTIVE |
คำขอทั้งหมดในโดเมนของคุณจะให้บริการโดยโฮสติ้งแอป ผ่านชาร์ดที่กำหนดของโดเมน หาก OwnershipState ของโดเมนที่กำหนดเองคือ OWNERSHIP_ACTIVE ด้วย โฮสติ้งแอปจะแสดงเนื้อหาแบ็กเอนด์ตามคำขอสำหรับโดเมน |
สถานะการเป็นเจ้าของ
สถานะการเป็นเจ้าของของโดเมนที่กำหนดเอง
Enum | |
---|---|
OWNERSHIP_STATE_UNSPECIFIED |
ไม่มีการระบุสถานะการเป็นเจ้าของโดเมนที่กำหนดเอง ซึ่งไม่ควรเกิดขึ้น |
OWNERSHIP_MISSING |
โดเมนของโดเมนที่กำหนดเองไม่มีระเบียนการเป็นเจ้าของที่เกี่ยวข้องกับโฮสติ้งแอป ไม่มีแบ็กเอนด์ได้รับสิทธิ์ให้แสดงในโดเมนในชาร์ดต้นทางนี้ |
OWNERSHIP_UNREACHABLE |
เข้าถึงโดเมนที่กำหนดเองไม่ได้ บริการโฮสติ้งแอป" เกิดข้อผิดพลาดในการค้นหา DNS เพื่อค้นหาระเบียนการเป็นเจ้าของโดเมนของคุณ ดูรายละเอียดเพิ่มเติมในช่อง issues ของ CustomDomainStatus |
OWNERSHIP_MISMATCH |
โดเมนที่กำหนดเองของคุณเป็นของโดเมนที่กำหนดเองสำหรับการโฮสต์แอปอีกอันหนึ่ง นำระเบียนที่ขัดแย้งกันออกและแทนที่ด้วยระเบียนสำหรับโดเมนที่กำหนดเองในปัจจุบัน |
OWNERSHIP_CONFLICT |
โดเมนที่กำหนดเองของคุณมีระเบียน TXT ที่ขัดแย้งกันซึ่งบ่งชี้การเป็นเจ้าของโดยโดเมนที่กำหนดเองในปัจจุบันของคุณอย่างน้อย 1 คน โปรดนำระเบียนการเป็นเจ้าของส่วนเกินออกเพื่อให้สิทธิ์การเป็นเจ้าของโดเมนที่กำหนดเองในปัจจุบัน |
OWNERSHIP_PENDING |
ระเบียน DNS ของโดเมนที่กำหนดเองมีการกำหนดค่าอย่างถูกต้อง โฮสติ้งแอปจะโอนความเป็นเจ้าของโดเมนของคุณไปยังโดเมนที่กำหนดเองนี้ภายใน 24 ชั่วโมง |
OWNERSHIP_ACTIVE |
โดเมนที่กำหนดเองของคุณเป็นเจ้าของโดเมน |
สถานะการรับรอง
สถานะของโฮสติ้งแอปใบรับรอง SSL มีอยู่สำหรับชื่อโดเมนของคุณ ซึ่งอาจแสดงสถานะของใบรับรองจริง หรือสำหรับโดเมนที่กำหนดเองใหม่ คือความพยายามในการสร้างใบรับรองของโฮสติ้งแอป
Enum | |
---|---|
CERT_STATE_UNSPECIFIED |
ไม่ได้ระบุสถานะของใบรับรอง ข้อความไม่ถูกต้องหากไม่ได้ระบุ |
CERT_PREPARING |
สถานะเริ่มต้นของใบรับรองทุกใบจะแสดงถึง Intent ของโฮสติ้งแอปในการสร้างใบรับรองก่อนที่จะมีการส่งคำขอไปยังผู้ออกใบรับรอง |
CERT_VALIDATING |
App Hosting กำลังตรวจสอบว่าระเบียน DNS ของชื่อโดเมนอยู่ในสถานะที่อนุญาตให้สร้างใบรับรองในนามของโดเมนหรือไม่ |
CERT_PROPAGATING |
เพิ่งสร้างใบรับรองและต้องใช้เวลาในการเผยแพร่ในตัวจัดสรรภาระงานของโฮสติ้งแอป |
CERT_ACTIVE |
ใบรับรองมีการใช้งานอยู่ โดยมีการเชื่อมต่อที่ปลอดภัยสำหรับชื่อโดเมนที่ใบรับรองนั้นเป็นตัวแทน |
CERT_EXPIRING_SOON |
ใบรับรองกำลังจะหมดอายุ ชื่อโดเมนทั้งหมดในใบรับรองจะได้รับใบรับรองใหม่ |
CERT_EXPIRED |
ใบรับรองหมดอายุแล้ว App Hosting จะแสดงเนื้อหาที่รักษาความปลอดภัยในชื่อโดเมนของคุณไม่ได้อีกต่อไป |
การอัปเดต DNS
ชุดอัปเดตระเบียน DNS ที่คุณควรดำเนินการเพื่ออนุญาตให้โฮสติ้งแอปแสดงเนื้อหาที่ปลอดภัยตามคำขอในโดเมนของคุณ การอัปเดตเหล่านี้จะแสดงสถานะปัจจุบันของโดเมนและโดเมนย่อยที่เกี่ยวข้อง ระเบียน DNS เมื่อโฮสติ้งแอปค้นหาระเบียนดังกล่าวครั้งล่าสุด และชุดระเบียนที่ต้องการซึ่งโฮสติ้งแอปจำเป็นต้องดูก่อนจึงจะใช้งานโดเมนที่กำหนดเองได้อย่างสมบูรณ์
การแสดง JSON |
---|
{ "domainName": string, "discovered": [ { object ( |
ช่อง | |
---|---|
domainName |
เอาต์พุตเท่านั้น ชื่อโดเมนที่เกี่ยวข้องกับการอัปเดต DNS |
discovered[] |
เอาต์พุตเท่านั้น ชุดของระเบียน DNS โฮสติ้งแอปที่พบเมื่อตรวจสอบโดเมน |
desired[] |
เอาต์พุตเท่านั้น ชุดระเบียน DNS การโฮสต์แอปจำเป็นต้องใช้เพื่อให้แสดงเนื้อหาที่ปลอดภัยบนโดเมนได้ |
checkTime |
เอาต์พุตเท่านั้น ครั้งล่าสุดที่ App Hosting ได้ตรวจสอบระเบียน DNS ของโดเมนที่กำหนดเอง การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: |
ชุดระเบียน DnsRecord
ชุดของระเบียน DNS ที่เกี่ยวข้องกับการตั้งค่าและการบำรุงรักษาโดเมนที่กำหนดเองใน App Hosting
การแสดง JSON |
---|
{ "domainName": string, "checkError": { object ( |
ช่อง | |
---|---|
domainName |
เอาต์พุตเท่านั้น ชื่อโดเมนที่ชุดระเบียนใช้ |
checkError |
เอาต์พุตเท่านั้น พบข้อผิดพลาดในบริการโฮสติ้งแอปเมื่อค้นหาระเบียน DNS ของโดเมน หมายเหตุ: โฮสติ้งแอปจะไม่พิจารณาข้อผิดพลาด |
records[] |
เอาต์พุตเท่านั้น ระเบียนในโดเมน |
ระเบียน DNS
การแสดงระเบียน DNS สำหรับโดเมน
ระเบียน DNS คือระเบียนทรัพยากรที่กำหนดลักษณะการทำงานของระบบและบริการเมื่อจัดการคำขอสำหรับโดเมน ตัวอย่างเช่น เมื่อคุณเพิ่มระเบียน A
ลงในระเบียน DNS ของโดเมน จะเป็นการแจ้งให้ระบบอื่นๆ (เช่น เว็บเบราว์เซอร์ของผู้ใช้) ติดต่อที่อยู่ IPv4 เหล่านั้นเพื่อเรียกข้อมูลทรัพยากรที่เกี่ยวข้องกับโดเมน (เช่น ไฟล์โฮสติ้งของแอป)
การแสดง JSON |
---|
{ "domainName": string, "type": enum ( |
ช่อง | |
---|---|
domainName |
เอาต์พุตเท่านั้น โดเมนที่เกี่ยวข้องกับระเบียน เช่น |
type |
เอาต์พุตเท่านั้น ประเภทของระเบียน ซึ่งจะเป็นตัวกำหนดข้อมูลในระเบียน |
rdata |
เอาต์พุตเท่านั้น ข้อมูลของระเบียน ความหมายของค่าจะขึ้นอยู่กับประเภทระเบียน ซึ่งได้แก่ - A และ AAAA: ที่อยู่ IP สำหรับโดเมน - CNAME: โดเมนอื่นที่จะตรวจสอบระเบียน - TXT: สตริงข้อความที่กำหนดเองที่เชื่อมโยงกับโดเมน โฮสติ้งแอปใช้ระเบียน TXT เพื่อระบุว่าโปรเจ็กต์ Firebase ใดมีสิทธิ์ดำเนินการในนามของโดเมน - CAA: แฟล็ก แท็ก และค่าของระเบียน เช่น |
requiredAction |
เอาต์พุตเท่านั้น Enum ที่ระบุการดำเนินการที่จำเป็นสำหรับระเบียนนี้ จะมีการป้อนข้อมูลเมื่อระเบียนเป็นส่วนหนึ่งของการเปลี่ยนแปลงที่จำเป็นในชุดระเบียน |
relevantState[] |
เอาต์พุตเท่านั้น enum ที่ระบุสถานะที่ใช้กับระเบียน DNS ป้อนข้อมูลสำหรับระเบียนทั้งหมดที่มีการดำเนินการที่จำเป็น |
ประเภท
ประเภทของระเบียน DNS ได้แก่ A
, TXT
, AAAA
และ CAA
Enum | |
---|---|
TYPE_UNSPECIFIED |
ไม่ได้ระบุประเภทของระเบียน ข้อความไม่ถูกต้องหากไม่ได้ระบุ |
A |
ระเบียน A ตามที่กำหนดไว้ใน RFC 1035 ระเบียนจะระบุที่อยู่ IPv4 ที่โดเมนนำการรับส่งข้อมูลไป |
CNAME |
ระเบียน CNAME ตามที่กำหนดไว้ใน RFC 1035 ระเบียน CNAME หรือชื่อมาตรฐานจะแมปโดเมนกับโดเมน Canonical อื่น หากมีระเบียน CNAME อยู่ ระเบียนดังกล่าวควรเป็นระเบียนเดียวในโดเมน |
TXT |
ระเบียน TXT ตามที่กำหนดไว้ใน RFC 1035 ระเบียน TXT มีข้อมูลที่เป็นข้อความในโดเมน โฮสติ้งใช้ระเบียน TXT เพื่อระบุว่าโปรเจ็กต์ Firebase ใดมีสิทธิ์ดำเนินการกับโดเมน |
AAAA |
ระเบียน AAAA ตามที่ระบุไว้ในระเบียน AAAA RFC 3596 เป็นตัวกำหนดที่อยู่ IPv6 ที่โดเมนนำทางการเข้าชมไป |
CAA |
ระเบียน CAA ตามที่กําหนดไว้ใน RFC 6844 CAA หรือการให้สิทธิ์ผู้ออกใบรับรอง จะระบุว่าผู้ออกใบรับรอง (องค์กรที่สร้างใบรับรอง SSL) ใดได้รับอนุญาตให้สร้างใบรับรองสำหรับโดเมน App Hosting ใช้ CaA เรคคอร์ด Caacade ระเบียน CAA ใน คุณจะระบุระเบียน CAA หรือไม่ก็ได้ หากโดเมนและโดเมนระดับบนไม่มีระเบียน CAA ระบบของ CA ทั้งหมดจะได้รับสิทธิ์ในการสร้างใบรับรองที่สร้างในนามของโดเมนดังกล่าว โดยทั่วไปแล้ว โฮสติ้งแอปจะขอให้คุณแก้ไขระเบียน CAA เมื่อจำเป็นต้องเลิกบล็อกการสร้างใบรับรอง SSL เท่านั้น |
การดำเนินการ
ประเภทการดำเนินการที่คุณควรทำกับระเบียน DNS นี้เพื่อกำหนดค่าโดเมนสำหรับใช้กับ App Hosting
Enum | |
---|---|
NONE |
คุณไม่ต้องดำเนินการใดๆ |
ADD |
เพิ่มระเบียนนี้ลงในระเบียน DNS |
REMOVE |
นำระเบียนนี้ออกจากระเบียน DNS |
CustomDomainState
ชุดสถานะที่เกี่ยวข้องกับประสิทธิภาพการทำงานของโดเมนที่กำหนดเอง
Enum | |
---|---|
CUSTOM_DOMAIN_STATE_UNSPECIFIED |
ข้อความนี้ไม่ถูกต้องหากไม่ได้ระบุ |
HOST_STATE |
สถานะโฮสต์ของโดเมนที่กำหนดเอง |
OWNERSHIP_STATE |
สถานะการเป็นเจ้าของของโดเมนที่กำหนดเอง |
CERT_STATE |
สถานะใบรับรองของโดเมนที่กำหนดเอง |
เมธอด |
|
---|---|
|
ลิงก์โดเมนใหม่กับแบ็กเอนด์ |
|
ลบโดเมนเดียว |
|
รับข้อมูลเกี่ยวกับโดเมน |
|
แสดงรายการโดเมนของแบ็กเอนด์ |
|
อัปเดตข้อมูลสำหรับโดเมนเดียว |