REST Resource: projects.locations.zones

リソース: Zone

一連のハードウェアを保持するゾーン。

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 ペアとして指定します。ラベルの詳細については、ラベルの作成と管理をご覧ください。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
displayName

string

省略可。このゾーンの人間が読み取れる形式の表示名。
state

enum (State)

出力専用。このゾーンの現在の状態。
contacts[]

object (Contact)

必須。ゾーンの連絡先（名前、メールアドレス、電話番号）。順序依存: リストの最初の連絡先がプライマリ連絡先、2 番目がセカンダリ連絡先など。
ciqUri

string

出力専用。このゾーンのお客様情報アンケート（CIQ）シートへのリンク。
networkConfig

object (ZoneNetworkConfig)

省略可。このゾーンのネットワーキング構成。
globallyUniqueId

string

出力専用。この Edge Zone に対して生成されたグローバルに一意の識別子。
subscriptionConfigs[]

object (SubscriptionConfig)

出力専用。このゾーンのサブスクリプション構成。
provisioningState

enum (ProvisioningState)

出力専用。MAC アドレスなどの構成のプロビジョニング状態。
skipClusterProvisioning

boolean

省略可。ファクトリー ターンアップ時にクラスタ プロビジョニング ステップをスキップするかどうか。true の場合、ゾーンのハードウェアがお客様のサイトにインストールされた後に Kubernetes クラスタが作成されることを示します。
clusterIntentRequired

boolean

出力専用。注文を承諾する前に、お客様が有効なクラスタ インテントを提供する必要があるかどうかを示します。true の場合、クラスタのインテントが存在するまで注文を受け付けることはできません。これは、早期検証を強制し、構成の欠落による遅延を防ぐために使用されます。
clusterIntentVerified

boolean

出力専用。指定されたクラスタ インテントが正常に検証されたかどうかを示します。このフラグにより、注文を受け付ける前にクラスタのインテントが存在することが保証されます。
aiCapable

boolean

出力専用。このゾーンが Gemini on GDC Software クラスタ用かどうかを示します。
intelPccsKey

string

省略可。AI アクセラレータ ハードウェアのプロビジョニングと構成証明に使用する Intel Platform Config and Attestation Service（PCCS）キー。GDC Software クラスタで 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 Zone の出荷時設定チェックに失敗しました。
ACTIVE ゾーンを使用できます。
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 アドレス ブロック。ゾーン内のマシンごとに少なくとも 1 つのアドレスを割り振るのに十分な大きさのプライベート RFC1918 またはパブリック CIDR ブロックである必要があります。managementIpv4Subnet の範囲内で、他のアドレス範囲と重複しないようにする必要があります。
kubernetesNodeIpv4Range

string

必須。Kubernetes ノードの IPv4 アドレス ブロック。ゾーン内のマシンごとに少なくとも 1 つのアドレスを割り振るのに十分な大きさのプライベート RFC1918 またはパブリック CIDR ブロックである必要があります。kubernetesIpv4Subnet の範囲内で、他のアドレス範囲と重複しないようにする必要があります。
kubernetesControlPlaneIpv4Range

string

必須。Kubernetes コントロール プレーンの IPv4 アドレス ブロック。ゾーン内のクラスタごとに少なくとも 1 つのアドレスを割り振るのに十分な大きさのプライベート 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)

省略可。GDC Software クラスタで Gemini を提供するゾーンの IPv4 サブネット。指定された範囲の最後の /29 サブネットは DHCP 用に予約されています。
bgpConfig

object (BGPConfig)

省略可。このゾーンの Border Gateway Protocol（BGP）固有の構成。GDC Software クラスタで Gemini を提供するゾーンで使用されます。
topLevelDomain

string

省略可。このゾーンのカスタム トップレベル ドメイン。GDC Software クラスタで Gemini を提供するゾーンで使用されます。
torSwitchType

string

省略可。お客様の ToR スイッチのタイプに関する追加情報。GDC Software クラスタで Gemini を提供するゾーンで使用されます。

サブネット

サブネットを表します。

JSON 表現 
{
  "addressRange": string,
  "defaultGatewayIpAddress": string
}
フィールド
addressRange

string

必須。このサブネットのアドレス範囲（CIDR 表記）。
defaultGatewayIpAddress

string

必須。このサブネットのデフォルト ゲートウェイ。

BGPConfig

Border Gateway Protocol（BGP）の構成。

JSON 表現 
{
  "asn": string,
  "l3PeerIps": [
    string
  ]
}
フィールド
asn

string

必須。BGP 自律システム番号（ASN）。
l3PeerIps[]

string

必須。BGP ピア IP。少なくとも 2 つの L3 ピア IP が必要です。

ProvisioningState

MAC アドレスなどの構成の有効なプロビジョニング状態。

列挙型
PROVISIONING_STATE_UNSPECIFIED プロビジョニングの状態が指定されていません。
PROVISIONING_REQUIRED プロビジョニングが必要です。Google によって設定されます。
PROVISIONING_IN_PROGRESS プロビジョニング中です。お客様が設定します。
PROVISIONING_COMPLETE プロビジョニングが完了しました。お客様が設定します。

メソッド

create

 指定されたプロジェクトとロケーションに新しいゾーンを作成します。

delete

 ゾーンを削除します。

get

 ゾーンの詳細を取得します。

list

 指定されたプロジェクトとロケーションのゾーンを一覧表示します。

patch

 ゾーンのパラメータを更新します。

signal

 ゾーンの状態を通知します。