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

"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 ソフトウェア クラスタ用かどうかを示します。
intelPccsKey

string

省略可。AI アクセラレータ ハードウェアのプロビジョニングと証明に使用される Intel Platform Config and Attestation Service（PCCS）キー。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
currentResourceOperation

object (ResourceOperation)

出力専用。ゾーンの現在のリソース オペレーション。
resourceOperations[]

object (ResourceOperation)

省略可。ゾーンで実行されたすべてのリソース オペレーションのリスト。
errors[]

object (Status)

出力専用。ゾーンの起動中に発生したエラー。ErrorInfo メタデータには、タイムスタンプと、エラーが再試行可能かどうかが含まれます。
site

string

省略可。このゾーンのハードウェアが存在するサイトの名前を指定します。形式: projects/{project}/locations/{location}/sites/{site}。Gemini on GDC ソフトウェア ゾーンに必要です。

状態

ゾーンの有効な状態。

列挙型
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 Zone がオフラインです。
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 アドレス ブロック。ゾーン内のマシンごとに少なくとも 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)

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

object (BGPConfig)

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

string

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

string

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

string

省略可。境界プロキシのパブリック IPv4 範囲（CIDR 表記）。現在、/32 が想定されています。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
boundaryProxyPrivateEdgeCoreIpv4Range

string

省略可。境界プロキシのプライベート エッジからコアへの IPv4 範囲（CIDR 表記）。現在、/32 が想定されています。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
boundaryProxyPrivateCoreEdgeIpv4Range

string

省略可。境界プロキシのプライベート コアからエッジへの IPv4 範囲（CIDR 表記）。現在、/32 が想定されています。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
bastionHostPublicIpv4Range

string

省略可。踏み台インスタンスのパブリック IPv4 範囲（CIDR 表記）。現在、/32 が想定されています。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
bastionHostPrivateIpv4Range

string

省略可。CIDR 表記の踏み台インスタンスのプライベート IPv4 範囲。現在、/32 が想定されています。GDC ソフトウェア クラスタで Gemini を提供するゾーンで使用されます。
tlsPublicRootCertificatePem

string

省略可。PEM 形式の TLS 公開ルート証明書。GDC ソフトウェア クラスタで 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

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