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
}
欄位
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。

狀態

可用區的有效狀態。

列舉
STATE_UNSPECIFIED 未指定可用區狀態。
ADDITIONAL_INFO_NEEDED 我們需要顧客提供更多資訊，才能繼續處理。
PREPARING Google 正在準備區域。
READY_FOR_CUSTOMER_FACTORY_TURNUP_CHECKS 工廠啟動成功。
CUSTOMER_FACTORY_TURNUP_CHECKS_STARTED Zone 正在執行工廠啟動檢查。
READY_FOR_SITE_TURNUP 區域已準備好啟用網站。
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
}
欄位
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。如要將網路分成不同的區隔，可以選擇分隔該節點與網路。

子網路

代表子網路。

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

string

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

string

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

SubscriptionConfig

用於儲存訂閱項目設定的訊息。

JSON 表示法 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
欄位
subscriptionId

string

僅供輸出。訂閱項目的專屬 ID。
billingId

string

僅供輸出。訂閱方案建立時所用的 Google Cloud 帳單 ID。
state

enum (SubscriptionState)

僅供輸出。訂閱方案的目前狀態。

SubscriptionState

列舉表示訂閱狀態。

列舉
SUBSCRIPTION_STATE_UNSPECIFIED 未指定狀態。
ACTIVE 「有效」狀態表示訂閱項目已成功建立，且正在計費。
INACTIVE 「非使用中」表示訂閱方案已成功建立，但尚未開始計費。
ERROR 訂閱項目處於錯誤狀態。
FAILED_TO_RETRIEVE 無法擷取訂閱狀態。這可能是暫時性問題。使用者應重試要求。
COMPLETED 訂閱已到期，因此已完成。

ProvisioningState

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

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

方法

create

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

delete

 刪除區域。

get

 取得區域的詳細資料。

list

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

patch

 更新可用區的參數。

signal

 指出區域的狀態。