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
}
フィールド
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)

必須。連絡先。
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

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

状態

ゾーンの有効な状態。

列挙型
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 Zone の出荷時設定チェックに失敗しました。
ACTIVE ゾーンを使用できます。
CANCELLED ゾーンがキャンセルされました。

ZoneNetworkConfig

ゾーンのネットワーク構成。

JSON 表現 
{
  "machineMgmtIpv4Range": string,
  "kubernetesNodeIpv4Range": string,
  "kubernetesControlPlaneIpv4Range": string,
  "managementIpv4Subnet": {
    object (Subnet)
  },
  "kubernetesIpv4Subnet": {
    object (Subnet)
  },
  "dnsIpv4Addresses": [
    string
  ],
  "kubernetesPrimaryVlanId": integer
}
フィールド
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 に配置されています。ネットワーク セグメンテーションの目的で、これらを任意で分離できます。

サブネット

サブネットを表します。

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

string

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

string

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

SubscriptionConfig

サブスクリプション構成を保存するメッセージ。

JSON 表現 
{
  "subscriptionId": string,
  "billingId": string,
  "state": enum (SubscriptionState)
}
フィールド
subscriptionId

string

出力専用。定期購入の一意の識別子。
billingId

string

出力専用。サブスクリプションが作成される Google Cloud Billing 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

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