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)
}
フィールド
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 アドレスなどの構成のプロビジョニング状態。

状態

ゾーンの有効な状態。

列挙型
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

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