REST Resource: projects.locations.zones

資源：可用區

可用區包含一組硬體。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "displayName": string,
  "state": enum (State),
  "contacts": [
    {
      object (Contact)
    }
  ],
  "ciqUri": string,
  "networkConfig": {
    object (ZoneNetworkConfig)
  },
  "globallyUniqueId": string,
  "subscriptionConfigs": [
    {
      object (SubscriptionConfig)
    }
  ],
  "provisioningState": enum (ProvisioningState),
  "skipClusterProvisioning": boolean,
  "clusterIntentRequired": boolean,
  "clusterIntentVerified": boolean,
  "aiCapable": boolean,
  "intelPccsKey": string
}
欄位
name

string

ID。這個區域的名稱。格式：projects/{project}/locations/{location}/zones/{zone}
createTime

string (Timestamp format)

僅供輸出。這個區域的建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。上次更新這個區域的時間。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
labels

map (key: string, value: string)

選用。與這個區域相關聯的標籤，以鍵/值組合的形式呈現。如要進一步瞭解標籤，請參閱「建立及管理標籤」。

包含 "key": value 組合清單的物件，範例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
displayName

string

選用。這個區域的易記顯示名稱。
state

enum (State)

僅供輸出。這個可用區的目前狀態。
contacts[]

object (Contact)

這是必要旗標，區域聯絡窗口 (姓名、電子郵件地址、電話號碼)。順序決定：清單中的第一個聯絡人是主要聯絡人，第二個是次要聯絡人，依此類推。
ciqUri

string

僅供輸出。這個區域的客戶問卷調查 (CIQ) 表單連結。
networkConfig

object (ZoneNetworkConfig)

選用。這個可用區的網路設定。
globallyUniqueId

string

僅供輸出。系統為這個 Edge Zone 產生的全域專屬 ID。
subscriptionConfigs[]

object (SubscriptionConfig)

僅供輸出。這個可用區的訂閱設定。
provisioningState

enum (ProvisioningState)

僅供輸出。設定 (例如 MAC 位址) 的佈建狀態。
skipClusterProvisioning

boolean

選用。是否要在工廠啟動期間略過叢集佈建步驟。如果為 true，表示 Kubernetes 叢集會在客戶端安裝區域的硬體後建立。
clusterIntentRequired

boolean

僅供輸出。指出顧客是否必須先提供有效的叢集意圖，才能接受訂單。如為 true，必須先設定叢集意圖，才能接受訂單。這項功能可用於強制執行初步驗證，避免因缺少設定而導致延遲。
clusterIntentVerified

boolean

僅供輸出。指出提供的叢集意圖是否已成功驗證。這個標記可確保叢集意圖存在，才能接受訂單。
aiCapable

boolean

僅供輸出。指出這個區域是否適用於 GDC 軟體叢集上的 Gemini。
intelPccsKey

string

選用。Intel 平台設定和認證服務 (PCCS) 金鑰，用於佈建及認證 AI 加速器硬體。用於在 GDC 軟體叢集上提供 Gemini 的區域。

狀態

可用區的有效狀態。

列舉
STATE_UNSPECIFIED 未指定可用區狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
INFO_COMPLETE 專區提供開始準備專區所需的所有資訊。
PREPARING Google 正在準備區域。
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 工廠啟動成功。
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED Zone 正在執行工廠啟動檢查。
READY_FOR_PROVISIONING 區域已可佈建。
READY_FOR_SITE_TURNUP 區域已準備好啟用網站。
PROVISIONING_STARTED 系統已開始佈建區域。
PROVISIONING_FAILED 區域佈建失敗。
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 區域未通過工廠啟動檢查。
ACTIVE 現在可以使用 Zone。
CANCELLED 已取消區域。

ZoneNetworkConfig

可用區的網路設定。

JSON 表示法 
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer,
  "aiCapableIpv4Subnet": {
    object (Subnet)
  },
  "bgpConfig": {
    object (BGPConfig)
  },
  "topLevelDomain": string,
  "torSwitchType": string
}
欄位
machineMgmtIpv4Range

string

這是必要旗標，機器管理的 IPv4 位址區塊。應為私人 RFC1918 或公開 CIDR 區塊，大小足以在區域中為每部機器分配至少一個位址。應位於 managementIpv4Subnet，且與其他位址範圍不相交。
kubernetesNodeIpv4Range

string

這是必要旗標，Kubernetes 節點的 IPv4 位址區塊。應為私人 RFC1918 或公開 CIDR 區塊，大小足以在區域中為每部機器分配至少一個位址。應位於 kubernetesIpv4Subnet，且與其他位址範圍不相交。
kubernetesControlPlaneIpv4Range

string

這是必要旗標，Kubernetes 控制層的 IPv4 位址區塊。應為私人 RFC1918 或公開 CIDR 區塊，大小足以在區域中為每個叢集分配至少一個位址。應位於 kubernetesIpv4Subnet，且與其他位址範圍不相交。
managementIpv4Subnet

object (Subnet)

這是必要旗標，管理網路的 IPv4 子網路。
kubernetesIpv4Subnet

object (Subnet)

選用。Kubernetes 網路的 IPv4 子網路。如未指定，Kubernetes 子網路會與管理子網路相同。
dnsIpv4Addresses[]

string

選用。DNS 網域名稱伺服器。GDC 基礎架構會透過這些 IP 解析 DNS 查詢。如未指定，則會使用 Google DNS。
kubernetesPrimaryVlanId

integer

選用。Kubernetes VLAN ID。根據預設，Kubernetes 節點 (包括主要 Kubernetes 網路) 會與機器管理網路位於相同的 VLAN。如要將網路分成不同的區隔，可以選擇分隔該節點與網路。
aiCapableIpv4Subnet

object (Subnet)

選用。為 Gemini on GDC Software 叢集提供服務的區域 IPv4 子網路。所提供範圍的最後一個 /29 子網路會保留給 DHCP 使用。
bgpConfig

object (BGPConfig)

選用。這個區域的邊界閘道通訊協定 (BGP) 專屬設定。用於在 GDC 軟體叢集上提供 Gemini 的區域。
topLevelDomain

string

選用。這個區域的自訂頂層網域。用於在 GDC 軟體叢集上提供 Gemini 的區域。
torSwitchType

string

選用。客戶的 ToR 轉換類型相關額外資訊。用於在 GDC 軟體叢集上提供 Gemini 的區域。

子網路

代表子網路。

JSON 表示法 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
欄位
addressRange

string

這是必要旗標，這個子網路的位址範圍 (以 CIDR 標記法表示)。
defaultGatewayIpAddress

string

這是必要旗標，這個子網路的預設閘道。

BGPConfig

邊界閘道通訊協定 (BGP) 設定。

JSON 表示法 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
欄位
asn

string

這是必要旗標，BGP 自治系統編號 (ASN)。
l3PeerIps[]

string

這是必要旗標，BGP 對等互連 IP。至少需要兩個 L3 對等互連 IP。

ProvisioningState

設定 (例如 MAC 位址) 的有效佈建狀態。

列舉
PROVISIONING_STATE_UNSPECIFIED 未指定佈建狀態。
PROVISIONING_REQUIRED 必須佈建。由 Google 設定。
PROVISIONING_IN_PROGRESS 正在佈建，由顧客設定。
PROVISIONING_COMPLETE 佈建完成。由顧客設定。

方法

create

 在指定專案和位置中建立新區域。

delete

 刪除區域。

get

 取得區域的詳細資料。

list

 列出指定專案和位置中的區域。

patch

 更新可用區的參數。

signal

 指出區域的狀態。