REST Resource: projects.sites.customDomains

{
  "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,
    ...
  }
}

string

僅輸出。 CustomDomain的完全限定名稱。

map (key: string, value: string)

您可以新增註解以留下有關CustomDomain的人類和機器可讀的元資料。

包含"key": value對。範例： { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

string ( Timestamp format)

僅輸出。自訂網域的建立時間。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

string ( Timestamp format)

僅輸出。上次更新CustomDomain時間。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

string ( Timestamp format)

僅輸出。 CustomDomain被刪除的時間；對於尚未刪除的自訂網域，為 null。刪除的自訂網域會保留約 30 天，之後託管會將其完全刪除。若要恢復已刪除的自訂網域，請發出customDomains.undelete請求。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

string ( Timestamp format)

僅輸出。軟刪除的CustomDomain從託管中完全刪除之前的最短時間；對於尚未刪除的自訂網域，為 null。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

string

僅輸出。一個字串，表示CustomDomain的當前狀態，並允許您在修改它的請求中確認其初始狀態。使用此標記可確保發出customDomains.patch 、 customDomains.delete和customDomains.undelete要求時的一致性。

enum ( HostState )

僅輸出。此CustomDomain引用的網域的HostState 。

enum ( OwnershipState )

僅輸出。此CustomDomain引用的網域的OwnershipState 。

object ( DnsUpdates )

僅輸出。您應對網域的 DNS 記錄進行一組更新，以便託管代表其提供安全內容。

object ( Status )

僅輸出。主機系統在嘗試建立主機為您的網域提供安全內容的能力時遇到的一組錯誤。解決這些問題以確保您的CustomDomain正常運作。

enum ( Type )

此欄位可讓您指定 Hosting 為您的網域建立哪種 SSL 憑證類型。 Spark 計畫自訂網域只能存取GROUPED憑證類型，而 Blaze 計畫網域可以選擇任何選項。

object ( Certificate )

僅輸出。託管擁有此自訂網域的網域的 SSL 憑證。對於新的自訂網域，這通常代表託管建立憑證的意圖，而不是實際的憑證。檢查state字段以了解更多資訊。

string

此CustomDomain應將流量引導至的網域名稱。如果指定，託管將使用 HTTP 301 程式碼回應針對此自訂網域的請求，並將流量路由到指定的redirectTarget 。

boolean

僅輸出。該欄位如果為 true，則表示 Hosting 的系統正在嘗試使自訂網域的狀態與您的首選狀態相符。當在customDomains.create請求後最初配置CustomDomain時，或在customDomains.patch請求後建立新的 SSL 憑證以符合更新的certPreference時，最常見的true是這樣。

map (key: string, value: string)

用於額外元資料和/或過濾的標籤。

包含"key": value對。範例： { "name": "wrench", "mass": "1.3kg", "count": "3" } 。

{
  "discovered": [
    {
      object (DnsRecordSet)
    }
  ],
  "desired": [
    {
      object (DnsRecordSet)
    }
  ],
  "checkTime": string
}

object ( DnsRecordSet )

Hosting 在檢查網域時發現的 DNS 記錄集。

object ( DnsRecordSet )

託管需要在網域上提供安全內容的 DNS 記錄集。

string ( Timestamp format)

託管上次檢查您的自訂網域的 DNS 記錄。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

{
  "domainName": string,
  "checkError": {
    object (Status)
  },
  "records": [
    {
      object (DnsRecord)
    }
  ]
}

string

僅輸出。記錄集所屬的網域名稱。

object ( Status )

僅輸出。查詢網域的 DNS 記錄時託管服務遇到錯誤。注意：託管會忽略NXDOMAIN錯誤，因為這些錯誤通常只表示尚未設定網域。

object ( DnsRecord )

僅輸出。域上的記錄。

{
  "domainName": string,
  "type": enum (Type),
  "rdata": string,
  "requiredAction": enum (Action)
}

string

僅輸出。記錄所屬的域名，例如foo.bar.com. 。

enum ( Type )

僅輸出。記錄的類型，決定記錄包含哪些資料。

string

僅輸出。記錄的數據。該值的意義取決於記錄類型： - A 和 AAAA：網域名稱的 IP 位址。 - CNAME：另一個用於檢查記錄的網域。 - TXT：與網域名稱關聯的任意文字字串。託管使用 TXT 記錄來確定哪些 Firebase 項目有權代表網域執行操作。 - CAA：記錄的標誌、標籤和值，例如0 issue "pki.goog" 。

enum ( Action )

僅輸出。一個枚舉，指示此記錄所需的操作。

{
  "type": enum (Type),
  "state": enum (CertState),
  "verification": {
    object (CertVerification)
  },
  "issues": [
    {
      object (Status)
    }
  ],
  "createTime": string,
  "expireTime": string
}

enum ( Type )

僅輸出。證書的類型。

enum ( CertState )

僅輸出。證書的狀態。只有CERT_ACTIVE和CERT_EXPIRING_SOON狀態為網域提供 SSL 覆蓋。如果狀態為PROPAGATING並且託管先前擁有該網域的活動證書，則該先前的活動證書將為該網域提供 SSL 覆蓋，直到目前證書傳播為止。

object ( CertVerification )

僅輸出。您可以將一組 ACME 挑戰添加到您的 DNS 記錄或現有的非 Hosting 託管提供者中，以允許 Hosting 在您將流量指向託管之前為您的網域建立 SSL 憑證。您可以利用這些挑戰作為從舊提供者到託管的零停機過渡的一部分。

object ( Status )

僅輸出。 Hosting 在嘗試為您的網域建立憑證時遇到的一組錯誤。解決這些問題以確保託管能夠為您網站的訪客提供安全的通訊。

string ( Timestamp format)

僅輸出。證書的建立時間。對於TEMPORARY證書，這是託管首次為您的網域產生挑戰的時間。對於所有其他證書類型，這是實際證書的建立時間。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

string ( Timestamp format)

僅輸出。證書的過期時間。此後，該憑證將無法再用於在託管和您網站的訪客之間提供安全通訊。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

{
  "dns": {
    object (DnsUpdates)
  },
  "http": {
    object (HttpUpdate)
  }
}

object ( DnsUpdates )

僅輸出。新增至您的 DNS 記錄的TXT記錄，用於確認您讓託管為您的網域建立 SSL 憑證的意圖。

object ( HttpUpdate )

僅輸出。新增至您現有的非 Hosting 託管服務的文件，用於確認您讓 Hosting 為您的網域建立 SSL 憑證的意圖。

{
  "path": string,
  "desired": string,
  "discovered": string,
  "lastCheckTime": string,
  "checkError": {
    object (Status)
  }
}

string

僅輸出。文件的路徑。

string

僅輸出。在路徑中提供的文字字串。

string

僅輸出。 Hosting 在上次檢查期間是否能夠在指定路徑上找到所需的文件內容。

string ( Timestamp format)

僅輸出。託管系統上次檢查文件內容的時間。

RFC3339 UTC「Zulu」格式的時間戳，具有奈秒解析度和最多九個小數位。範例： "2014-10-02T15:01:23Z"和"2014-10-02T15:01:23.045123456Z" 。

object ( Status )

僅輸出。上次內容檢查期間遇到錯誤。如果為 null，則檢查成功完成。