既存の VMware ユーザー クラスタとそのノードプールを、特定のプロジェクトとロケーションの Anthos On-Prem API に登録します。登録により、既存のクラスタは Anthos On-Prem API で管理されるようになります。対応する GCP リソースが作成され、クラスタやそのノードプールに対する今後の変更はすべて API を介して実行されることが想定されます。
HTTP リクエスト
POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/vmwareClusters:enroll
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
parent |
必須。クラスタが登録されているプロジェクトとロケーションの親。形式: projects/{project}/locations/{location} |
リクエストの本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "vmwareClusterId": string, "localName": string, "adminClusterMembership": string, "validateOnly": boolean } |
フィールド | |
---|---|
vmware |
リソース名の一部として使用される、ユーザーが指定した OnePlatform ID。これは、プロジェクトとロケーション内のすべての GKE On-Prem クラスタ間で一意である必要があります。クラスタがすでに存在する場合は、409 が返されます。 |
local |
省略可。関連付けられた管理クラスタの VMware OnPremUserCluster カスタム リソースのオブジェクト名。このフィールドは、既存のクラスタを API に登録するときにリソース名の競合に対応するために使用されます。指定しない場合、このフィールドは vmwareClusterId に解決されます。それ以外の場合は、VMware OnPremUserCluster カスタム リソースのオブジェクト名と一致する必要があります。登録オペレーション以外では変更できません。 |
admin |
必須。この VMware ユーザー クラスタが属する管理クラスタ。これは、管理クラスタのフリート メンバーシップの完全なリソース名です。今後、管理クラスタが独自のリソースとしてモデル化される場合は、他のリソースタイプへの参照が許可される可能性があります。 |
validate |
実際に更新せずにリクエストを検証します。 |
レスポンスの本文
成功した場合、レスポンスの本文には Operation
のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
詳細については、Authentication Overview をご覧ください。