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,
  "currentResourceOperation": {
    object (ResourceOperation)
  },
  "resourceOperations": [
    {
      object (ResourceOperation)
    }
  ],
  "errors": [
    {
      object (Status)
    }
  ],
  "site": 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

僅供輸出。為這個邊緣可用區產生的全域專屬 ID。
subscriptionConfigs[]

object (SubscriptionConfig)

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

enum (ProvisioningState)

僅供輸出。MAC 位址等設定的佈建狀態。
skipClusterProvisioning

boolean

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

boolean

僅供輸出。指出客戶是否必須先提供有效的叢集意圖，才能接受訂單。如果為 true，則必須先設定叢集意圖，才能接受訂單。這項設定可強制執行早期驗證，避免因缺少設定而造成延遲。
clusterIntentVerified

boolean

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

boolean

選用。指出這個可用區是否用於 Gemini on GDC Software 叢集。
intelPccsKey

string

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

object (ResourceOperation)

僅供輸出。可用區目前的資源作業。
resourceOperations[]

object (ResourceOperation)

選用。在可用區執行的所有資源作業清單。
errors[]

object (Status)

僅供輸出。可用區啟用期間發生的錯誤。ErrorInfo 中繼資料會包含時間戳記，以及錯誤是否可重試。
site

string

選用。指定這個可用區中硬體所在的地點名稱。格式：projects/{project}/locations/{location}/sites/{site}。Gemini on GDC Software 可用區必須提供這項資訊。

狀態

可用區的有效狀態。

列舉
STATE_UNSPECIFIED 未指定區域狀態。
ADDITIONAL_INFO_NEEDED 客戶必須提供更多資訊，才能繼續處理。
INFO_COMPLETE 區域具備所有必要資訊，可開始準備區域。
PREPARING Google 正在準備可用區。
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 已成功完成工廠啟動作業。
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED 區域正在執行工廠啟動檢查。
READY_FOR_PROVISIONING 可用區已可佈建。
READY_FOR_SITE_TURNUP 該區域已可啟用網站。
PROVISIONING_STARTED 已開始佈建區域。
PROVISIONING_FAILED 無法佈建可用區。
OFFLINE 區域已離線。
CUSTOMER_FACTORY_TURNUP_CHECKS_FAILED 區域未通過原廠啟動檢查。
ACTIVE 可以使用這個可用區。
CANCELLED 已取消區域。
AWAITING_HARDWARE 區域正在等待硬體關聯。

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,
  "boundaryProxyPublicIpv4Range": string,
  "boundaryProxyPrivateEdgeCoreIpv4Range": string,
  "boundaryProxyPrivateCoreEdgeIpv4Range": string,
  "bastionHostPublicIpv4Range": string,
  "bastionHostPrivateIpv4Range": string,
  "tlsPublicRootCertificatePem": 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 Software 叢集提供 Gemini 服務的可用區使用。
topLevelDomain

string

選用。這個區域的自訂頂層網域。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
torSwitchType

string

選用。客戶 ToR 交換器類型的其他資訊。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundaryProxyPublicIpv4Range

string

選用。邊界 Proxy 公開 IPv4 範圍 (CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundaryProxyPrivateEdgeCoreIpv4Range

string

選用。邊界 Proxy 私人邊緣至核心 IPv4 範圍 (採用 CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
boundaryProxyPrivateCoreEdgeIpv4Range

string

選用。邊界 Proxy 私人核心至邊緣 IPv4 範圍 (採用 CIDR 標記法)。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
bastionHostPublicIpv4Range

string

選用。以 CIDR 標記法表示的堡壘主機公開 IPv4 範圍。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
bastionHostPrivateIpv4Range

string

選用。以 CIDR 標記法表示的堡壘主機私人 IPv4 範圍。目前應為 /32。由在 GDC Software 叢集提供 Gemini 服務的可用區使用。
tlsPublicRootCertificatePem

string

選用。PEM 格式的 TLS 公開根憑證。由在 GDC Software 叢集提供 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

 表示區域狀態。