REST Resource: projects.locations.clusters

リソース: Cluster

Google Distributed Cloud Edge Kubernetes クラスタ。

JSON 表現 
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "fleet": {
    object (Fleet)
  },
  "networking": {
    object (ClusterNetworking)
  },
  "authorization": {
    object (Authorization)
  },
  "defaultMaxPodsPerNode": integer,
  "endpoint": string,
  "clusterCaCertificate": string,
  "maintenancePolicy": {
    object (MaintenancePolicy)
  },
  "controlPlaneVersion": string,
  "nodeVersion": string
}
フィールド
name

string

必須。クラスタのリソース名。
createTime

string (Timestamp format)

出力専用。クラスタが作成された日時。

RFC3339 UTC「Zulu」形式のタイムスタンプであり、精度はナノ秒まで、小数点以下は最大 9 桁です。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

出力専用。クラスタが最後に更新された時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプであり、精度はナノ秒まで、小数点以下は最大 9 桁です。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"
labels

map (key: string, value: string)

このリソースに関連付けられたラベル。

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

object (Fleet)

省略可。フリート構成。
networking

object (ClusterNetworking)

必須。クラスタ全体のネットワーキング構成。
authorization

object (Authorization)

必須。変更不可。GEC によって適用および管理される RBAC ポリシー。
defaultMaxPodsPerNode

integer

省略可。このクラスタ内のノードプールに最大値が明示的に指定されていない場合に使用される、ノードあたりのデフォルトの最大 Pod 数。これが指定されていない場合は、Kubernetes のデフォルト値が使用されます。
endpoint

string

出力専用。Kubernetes API サーバーの IP アドレス。
clusterCaCertificate

string

出力専用。クラスタの CA の PEM でエンコードされた公開証明書。
maintenancePolicy

object (MaintenancePolicy)

省略可。クラスタ全体のメンテナンス ポリシー構成。
controlPlaneVersion

string

出力専用。コントロール プレーンのリリース バージョン
nodeVersion

string

出力専用。すべてのワーカーノードの中で最も低いリリース バージョン。クラスタにワーカーノードがない場合、このフィールドは空にできます。

フリート

フリート関連の構成。

フリートとは、複数のクラスタを論理的に編成するための Google Cloud のコンセプトです。フリートを使用することによって、マルチクラスタ機能の使用と管理、複数のシステム間での一貫したポリシーの適用が可能になります。

JSON 表現 
{
  "project": string,
  "membership": string
}
フィールド
project

string

必須。このクラスタが登録されるフリート ホスト プロジェクトの名前。

プロジェクト名の形式は projects/<project-number> です。
membership

string

出力専用。このクラスタに関連付けられているマネージド Hub メンバーシップ リソースの名前。

メンバーシップ名の形式は projects/<project-number>/locations/global/membership/<cluster-id> です。

ClusterNetworking

クラスタ全体のネットワーキング構成。

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

string

必須。クラスタ内のすべての Pod には、これらのブロックから RFC1918 IPv4 アドレスが割り当てられます。単一のブロックのみがサポートされます。作成後にこのフィールドを変更することはできません。
servicesIpv4CidrBlocks[]

string

必須。クラスタ内のすべてのサービスには、これらのブロックから RFC1918 IPv4 アドレスが割り当てられます。単一のブロックのみがサポートされます。作成後にこのフィールドを変更することはできません。

承認

GEC によって適用および管理される RBAC ポリシー。

JSON 表現 
{
  "adminUsers": {
    object (ClusterUser)
  }
}
フィールド
adminUsers

object (ClusterUser)

必須。クラスタへの完全アクセス権をもつクラスタ管理者ロールが付与されるユーザー。現在は単一のフィールドですが、将来的には複数の管理者を指定できるようになる予定です。

ClusterUser

RBAC ポリシーのユーザー プリンシパル。

JSON 表現 
{
  "username": string
}
フィールド
username

string

必須。有効な Google ユーザー名。

MaintenancePolicy

メンテナンス ポリシーの構成。

JSON 表現 
{
  "window": {
    object (MaintenanceWindow)
  }
}
フィールド
window

object (MaintenanceWindow)

メンテナンスが実行されるメンテナンスの時間枠を指定します。

MaintenanceWindow

メンテナンスの時間枠の構成

JSON 表現 
{
  "recurringWindow": {
    object (RecurringTimeWindow)
  }
}
フィールド
recurringWindow

object (RecurringTimeWindow)

定期的なメンテナンスの時間枠の構成。

RecurringTimeWindow

繰り返される任意の期間を表します。

JSON 表現 
{
  "window": {
    object (TimeWindow)
  },
  "recurrence": string
}
フィールド
window

object (TimeWindow)

最初の定期購入の期間。
recurrence

string

このウィンドウの繰り返し方法を示す RRULE（https://tools.ietf.org/html/rfc5545#section-3.8.5.3）。開始時刻から終了時刻までの期間にわたって実行されます。

TimeWindow

任意の期間を表します。

JSON 表現 
{
  "startTime": string,
  "endTime": string
}
フィールド
startTime

string (Timestamp format)

ウィンドウが最初に開始される時刻。

RFC3339 UTC「Zulu」形式のタイムスタンプであり、精度はナノ秒まで、小数点以下は最大 9 桁です。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"
endTime

string (Timestamp format)

ウィンドウの終了時刻。終了時間は開始時間より後にする必要があります。

RFC3339 UTC「Zulu」形式のタイムスタンプであり、精度はナノ秒まで、小数点以下は最大 9 桁です。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。

メソッド

create

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

delete

 1 つのクラスタを削除します。

generateAccessToken

 クラスタのアクセス トークンを生成します。

get

 1 つのクラスタの詳細を取得します。

list

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

patch

 単一のクラスタのパラメータを更新します。