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 "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาล่าสุดที่อัปเดต CustomDomain

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
deleteTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ลบ CustomDomain ค่าว่างสำหรับโดเมนที่กำหนดเองที่ยังไม่ได้ลบ โดเมนที่กำหนดเองที่ถูกลบจะคงอยู่เป็นเวลาประมาณ 30 วัน หลังจากนั้นโฮสติ้งจะนำออกทั้งหมด หากต้องการกู้คืนโดเมนที่กำหนดเองซึ่งถูกลบไปแล้ว โปรดส่งคำขอcustomDomains.undelete

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
expireTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาขั้นต่ำก่อนที่ CustomDomain ที่ถูกลบแบบชั่วคราวจะถูกนำออกจากโฮสติ้งโดยสมบูรณ์ ค่าว่างสำหรับโดเมนที่กำหนดเองที่ยังไม่ได้ลบ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "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)

เอาต์พุตเท่านั้น ชุดการอัปเดตที่คุณควรดำเนินการกับระเบียน DNS ของชื่อโดเมนเพื่อให้โฮสติ้งแสดงเนื้อหาที่ปลอดภัยในนามของโฮสติ้ง
issues[]

object (Status)

เอาต์พุตเท่านั้น ชุดข้อผิดพลาดระบบโฮสติ้งที่พบขณะพยายามสร้างความสามารถของโฮสติ้งในการแสดงเนื้อหาที่ปลอดภัยสำหรับชื่อโดเมนของคุณ แก้ไขปัญหาเหล่านี้เพื่อให้ CustomDomain ทำงานได้อย่างถูกต้อง
certPreference

enum (Type)

ช่องที่ให้คุณระบุประเภทใบรับรอง SSL ที่โฮสติ้งสร้างขึ้นสำหรับชื่อโดเมนของคุณ โดเมนที่กำหนดเองของแผน Spark มีสิทธิ์เข้าถึงเฉพาะใบรับรองประเภท GROUPED ส่วนโดเมนแผน Blaze จะเลือกตัวเลือกใดก็ได้
cert

object (Certificate)

เอาต์พุตเท่านั้น โฮสติ้งใบรับรอง SSL มีสำหรับชื่อโดเมนของโดเมนที่กำหนดเองนี้ สำหรับโดเมนที่กำหนดเองใหม่ ชื่อโดเมนนี้มักแสดงถึงความตั้งใจของโฮสติ้งในการสร้างใบรับรอง ไม่ใช่ใบรับรองจริง ตรวจสอบช่อง state เพื่อดูข้อมูลเพิ่มเติม
redirectTarget

string

ชื่อโดเมนที่ CustomDomain นี้ควรเปลี่ยนเส้นทางการเข้าชมไป หากระบุไว้ โฮสติ้งจะตอบกลับคำขอจากโดเมนที่กำหนดเองนี้ด้วยโค้ด HTTP 301 และกำหนดเส้นทางการรับส่งข้อมูลไปยัง redirectTarget ที่ระบุแทน
reconciling

boolean

เอาต์พุตเท่านั้น ฟิลด์ที่หากเป็น "จริง" บ่งบอกว่าระบบของโฮสติ้งกำลังพยายามเพื่อทำให้สถานะของโดเมนที่กำหนดเองตรงกับสถานะที่คุณต้องการ ซึ่งมักจะเป็น true เมื่อจัดสรร CustomDomain ครั้งแรกหลังคำขอ customDomains.create หรือเมื่อสร้างใบรับรอง SSL ใหม่เพื่อให้ตรงกับ certPreference ที่อัปเดตหลังคำขอ customDomains.patch
labels

map (key: string, value: string)

ป้ายกำกับที่ใช้สำหรับข้อมูลเมตาเพิ่มเติมและ/หรือการกรอง

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

สถานะโฮสต์

สถานะโฮสต์ของชื่อโดเมน ระบบจะกำหนดสถานะโฮสต์โดยการตรวจสอบที่อยู่ IP แต่ละรายการที่เชื่อมโยงกับชื่อโดเมนของคุณเพื่อดูว่าแสดงเนื้อหาโฮสติ้งหรือไม่

Enum
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 ได้ไม่เกิน 1 รายการ คุณกำหนดความเป็นเจ้าของได้ 2 วิธี ดังนี้

* 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

Enum
OWNERSHIP_STATE_UNSPECIFIED ไม่มีการระบุสถานะการเป็นเจ้าของโดเมนที่กำหนดเอง ซึ่งไม่ควรเกิดขึ้น
OWNERSHIP_MISSING ชื่อโดเมนที่กำหนดเองของคุณไม่มีระเบียนการเป็นเจ้าของที่เกี่ยวข้องกับโฮสติ้ง ไม่มีโปรเจ็กต์ Firebase ที่มีสิทธิ์ดำเนินการในนามของชื่อโดเมน
OWNERSHIP_UNREACHABLE เข้าถึงชื่อโดเมนของโดเมนที่กำหนดเองไม่ได้ บริการโฮสติ้ง เกิดข้อผิดพลาดกับคำขอ DNS เพื่อค้นหาระเบียนการเป็นเจ้าของชื่อโดเมน ดูรายละเอียดเพิ่มเติมในช่อง issues ของออบเจ็กต์ CustomDomain
OWNERSHIP_MISMATCH ชื่อโดเมนของโดเมนที่กำหนดเองของคุณเป็นของโปรเจ็กต์ Firebase อื่น นำระเบียน TXT ที่ขัดแย้งกันออกและแทนที่ด้วยระเบียนเฉพาะโปรเจ็กต์สำหรับโปรเจ็กต์ Firebase ปัจจุบัน
OWNERSHIP_CONFLICT ชื่อโดเมนของโดเมนที่กำหนดเองมีระเบียน TXT ที่ขัดแย้งกันซึ่งระบุการเป็นเจ้าของทั้งโปรเจ็กต์ Firebase ปัจจุบันและโปรเจ็กต์อื่น นำบันทึกการเป็นเจ้าของของโปรเจ็กต์อื่นออกเพื่อให้สิทธิ์การเป็นเจ้าของโปรเจ็กต์ปัจจุบัน
OWNERSHIP_PENDING ระเบียน DNS ของโดเมนที่กำหนดเองมีการกำหนดค่าอย่างถูกต้อง โฮสติ้งจะโอนการเป็นเจ้าของโดเมนไปยัง CustomDomain นี้ภายใน 24 ชั่วโมง
OWNERSHIP_ACTIVE ชื่อโดเมนของโดเมนที่กำหนดเองมีระเบียน TXT รายการที่ให้สิทธิ์โปรเจ็กต์ดำเนินการในนามของโดเมน

การอัปเดต DNS

ชุดการอัปเดตระเบียน DNS ที่คุณควรดำเนินการเพื่ออนุญาตให้โฮสติ้งแสดงเนื้อหาที่ปลอดภัยตามคำขอในชื่อโดเมนของคุณ การอัปเดตเหล่านี้จะแสดงสถานะปัจจุบันของระเบียน DNS ของชื่อโดเมนเมื่อโฮสติ้งค้นหาระเบียนครั้งล่าสุด และชุดระเบียนที่ต้องการซึ่งโฮสติ้งต้องดูก่อน โดเมนที่กำหนดเองของคุณจึงจะใช้งานได้อย่างเต็มรูปแบบ

การแสดง JSON 
{
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": string
}
ช่อง
discovered[]

object (DnsRecordSet)

ชุดของโฮสติ้งระเบียน DNS ที่พบเมื่อตรวจสอบโดเมน
desired[]

object (DnsRecordSet)

ชุดของโฮสติ้งระเบียน DNS จำเป็นต้องแสดงเนื้อหาที่ปลอดภัยบนโดเมน
checkTime

string (Timestamp format)

ครั้งล่าสุดที่โฮสติ้งตรวจสอบระเบียน DNS ของโดเมนที่กำหนดเอง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ชุดระเบียน DnsRecord

ชุดของระเบียน DNS ที่เกี่ยวข้องกับการตั้งค่าและการบำรุงรักษาโดเมนที่กำหนดเองในโฮสติ้งของ Firebase

การแสดง JSON 
{
  "domainName": string,
  "checkError": {
    object (Status)
  },
  "records": [
    {
      object (DnsRecord)
    }
  ]
}
ช่อง
domainName

string

เอาต์พุตเท่านั้น ชื่อโดเมนที่ชุดระเบียนใช้
checkError

object (Status)

เอาต์พุตเท่านั้น เกิดข้อผิดพลาดกับบริการโฮสติ้งที่พบเมื่อสืบค้นระเบียน DNS ของชื่อโดเมน หมายเหตุ: โฮสติ้งจะไม่สนใจข้อผิดพลาด NXDOMAIN เนื่องจากมักหมายความว่ายังไม่ได้ตั้งค่าชื่อโดเมน
records[]

object (DnsRecord)

เอาต์พุตเท่านั้น ระเบียนในโดเมน

ระเบียน DNS

ระเบียน DNS คือระเบียนทรัพยากรที่กำหนดลักษณะการทำงานของระบบและบริการเมื่อจัดการคำขอสำหรับชื่อโดเมน ตัวอย่างเช่น เมื่อคุณเพิ่มระเบียน A ลงในระเบียน DNS ของชื่อโดเมน จะเป็นการแจ้งให้ระบบอื่นๆ (เช่น เว็บเบราว์เซอร์ของผู้ใช้) ติดต่อที่อยู่ 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)

เอาต์พุตเท่านั้น Enum ที่ระบุการดำเนินการที่จำเป็นสำหรับระเบียนนี้

ประเภท

ประเภทของระเบียน DNS ได้แก่ A, TXT, AAAA และ CAA

Enum
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 ใช้ pki.goog เป็น CA หลัก

CaA เรคคอร์ด Caacade ระเบียน CAA ใน foo.com จะมีผลกับ bar.foo.com ด้วย เว้นแต่ bar.foo.com จะมีชุดระเบียน CAA เป็นของตัวเอง

คุณจะระบุระเบียน CAA หรือไม่ก็ได้ หากชื่อโดเมนและโดเมนหลักไม่มีระเบียน CAA จะทำให้ CA ทั้งหมดได้รับอนุญาตให้สร้างใบรับรองที่สร้างในนามของโดเมนดังกล่าว โดยทั่วไปแล้ว โฮสติ้งจะขอให้คุณแก้ไขระเบียน CAA เมื่อจำเป็นต้องทำเช่นนั้นเพื่อเลิกบล็อกการสร้างใบรับรอง SSL เท่านั้น

การดำเนินการ

การดำเนินการเป็นการดำเนินการประเภทหนึ่งที่คุณควรทำกับระเบียน DNS นี้เพื่อกำหนดค่าโดเมนเพื่อใช้กับโฮสติ้งของ Firebase

Enum
NONE คุณไม่ต้องดำเนินการใดๆ
ADD เพิ่มระเบียนนี้ลงในระเบียน DNS
REMOVE นำระเบียนนี้ออกจากระเบียน DNS

ประเภท

ประเภทของใบรับรอง กำหนดวิธีที่ระบบโฮสติ้งจัดการในการสร้างและดูแลรักษาใบรับรอง

Enum
TYPE_UNSPECIFIED ไม่ได้ระบุประเภทของใบรับรอง ข้อความไม่ถูกต้องหากไม่ได้ระบุ
TEMPORARY ใบรับรองประเภทมีอายุสั้นที่ครอบคลุมชื่อโดเมนชั่วคราว ขณะที่โฮสติ้งจะสร้างใบรับรองที่ถาวรมากกว่า
GROUPED ใบรับรองมาตรฐานสำหรับโดเมนที่กำหนดเองของแผน Spark
PROJECT_GROUPED เฉพาะแพ็กเกจ Blaze เท่านั้น ใบรับรองที่ครอบคลุมชื่อโดเมนตั้งแต่ 1 ถึง 100 ชื่อซึ่งมีโดเมนที่กำหนดเองในโปรเจ็กต์ Firebase เดียวกัน
DEDICATED เฉพาะแพ็กเกจ Blaze เท่านั้น ใบรับรองที่ครอบคลุมชื่อโดเมนเดียว

ใบรับรอง

ใบรับรอง SSL ที่ใช้เพื่อเข้ารหัสจากต้นทางถึงปลายทางสำหรับคำขอเกี่ยวกับชื่อโดเมนของคุณ Certificate อาจเป็นใบรับรอง SSL จริง หรือสำหรับ Intent ของโฮสติ้งที่สร้างขึ้นใหม่สำหรับโดเมนที่กำหนดเอง

การแสดง 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 เท่านั้นที่จะมีความครอบคลุม SSL สำหรับชื่อโดเมน หากสถานะคือ PROPAGATING และโฮสติ้งมีใบรับรองที่ใช้งานอยู่สำหรับชื่อโดเมนก่อนหน้านี้ ใบรับรองที่ใช้งานอยู่ก่อนหน้านี้นั้นจะครอบคลุม SSL สำหรับชื่อโดเมนจนกว่าใบรับรองปัจจุบันจะเผยแพร่
verification

object (CertVerification)

เอาต์พุตเท่านั้น ชุดคำถาม ACME ที่คุณสามารถเพิ่มไปยังระเบียน DNS หรือผู้ให้บริการโฮสติ้งที่มีอยู่ที่ไม่ใช่โฮสติ้งเพื่ออนุญาตให้โฮสติ้งสร้างใบรับรอง SSL สำหรับชื่อโดเมนได้ก่อนที่คุณจะนำการเข้าชมไปยังโฮสติ้ง คุณสามารถใช้ชาเลนจ์เหล่านี้เพื่อเปลี่ยนช่วงพักการใช้งานจากผู้ให้บริการรายเดิมไปเป็นโฮสติ้งได้
issues[]

object (Status)

เอาต์พุตเท่านั้น ชุดของข้อผิดพลาดโฮสติ้งที่พบขณะพยายามสร้างใบรับรองสำหรับชื่อโดเมนของคุณ โปรดแก้ไขปัญหาเหล่านี้เพื่อให้โฮสติ้งสามารถสื่อสารกับผู้เข้าชมเว็บไซต์ได้อย่างปลอดภัย
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างใบรับรอง สำหรับใบรับรอง TEMPORARY นี่คือเวลาที่โฮสติ้งสร้างความท้าทายครั้งแรกสำหรับชื่อโดเมนของคุณ สำหรับใบรับรองประเภทอื่นๆ ทั้งหมด จะเป็นเวลาที่สร้างใบรับรองจริง

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
expireTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาหมดอายุของใบรับรอง หลังจากนั้น ใบรับรองจะใช้ในการสื่อสารที่ปลอดภัยระหว่างโฮสติ้งกับผู้เข้าชมเว็บไซต์ของคุณไม่ได้อีกต่อไป

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

สถานะการรับรอง

สถานะของใบรับรอง SSL ที่โฮสติ้งสำหรับชื่อโดเมนมี ซึ่งอาจแสดงสถานะของใบรับรองจริง หรือสำหรับโดเมนที่กำหนดเองใหม่ คือความพยายามของโฮสติ้งในการสร้างใบรับรอง

Enum
CERT_STATE_UNSPECIFIED ไม่ได้ระบุสถานะของใบรับรอง ข้อความไม่ถูกต้องหากไม่ได้ระบุ
CERT_PREPARING สถานะเริ่มต้นของใบรับรองทุกใบจะแสดงถึงความตั้งใจของโฮสติ้งในการสร้างใบรับรอง ก่อนที่จะมีการส่งคำขอไปยังผู้ออกใบรับรอง
CERT_VALIDATING โฮสติ้งกำลังตรวจสอบว่าระเบียน DNS ของชื่อโดเมนอยู่ในสถานะที่อนุญาตให้สร้างใบรับรองในนามของโดเมนหรือไม่
CERT_PROPAGATING เพิ่งสร้างใบรับรองและต้องใช้เวลาในการเผยแพร่ใน CDN ของโฮสติ้ง
CERT_ACTIVE ใบรับรองมีการใช้งานอยู่ โดยมีการเชื่อมต่อที่ปลอดภัยสำหรับชื่อโดเมนที่ใบรับรองนั้นเป็นตัวแทน
CERT_EXPIRING_SOON ใบรับรองกำลังจะหมดอายุ ชื่อโดเมนทั้งหมดในใบรับรองจะได้รับใบรับรองใหม่
CERT_EXPIRED ใบรับรองหมดอายุแล้ว โฮสติ้งจะแสดงเนื้อหาที่รักษาความปลอดภัยในชื่อโดเมนของคุณไม่ได้อีกต่อไป

การยืนยันการรับรอง

ชุดคำถาม ACME ที่คุณสามารถใช้เพื่ออนุญาตให้โฮสติ้งสร้างใบรับรอง SSL สำหรับชื่อโดเมนก่อนเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังเซิร์ฟเวอร์โฮสติ้ง ใช้ระบบทดสอบ DNS หรือ HTTP โดยไม่จำเป็นต้องระบุทั้ง 2 อย่าง

การแสดง JSON 
{
  "dns": {
    object (DnsUpdates)
  },
  "http": {
    object (HttpUpdate)
  }
}
ช่อง
dns

object (DnsUpdates)

เอาต์พุตเท่านั้น ระเบียน TXT ที่จะเพิ่มลงในระเบียน DNS ซึ่งจะยืนยันความตั้งใจในการอนุญาตให้โฮสติ้งสร้างใบรับรอง 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 "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
checkError

object (Status)

เอาต์พุตเท่านั้น เกิดข้อผิดพลาดระหว่างการตรวจสอบเนื้อหาครั้งล่าสุด หากค่าเป็น Null แสดงว่าการตรวจสอบเสร็จสมบูรณ์

เมธอด

create

 สร้าง CustomDomain

delete

 ลบ CustomDomain ที่ระบุ

get

 รับ CustomDomain ที่ระบุ

list

 แสดง CustomDomain แต่ละรายการที่เกี่ยวข้องกับเว็บไซต์หลักโฮสติ้งที่ระบุ

patch

 อัปเดต CustomDomain ที่ระบุ

undelete

 ยกเลิกการลบ CustomDomain ที่ระบุหากมีการลบออกชั่วคราว