Method: projects.locations.vmwareClusters.enroll

既存の 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

string

必須。クラスタが登録されているプロジェクトとロケーションの親。形式: projects/{project}/locations/{location}

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
フィールド
vmwareClusterId

string

リソース名の一部として使用される、ユーザーが指定した OnePlatform ID。これは、プロジェクトとロケーション内のすべての GKE On-Prem クラスタ間で一意である必要があります。クラスタがすでに存在する場合は、409 が返されます。

https://tools.ietf.org/html/rfc1123)形式。

localName

string

省略可。関連付けられた管理クラスタの VMware OnPremUserCluster カスタム リソースのオブジェクト名。このフィールドは、既存のクラスタを API に登録するときにリソース名の競合に対応するために使用されます。指定しない場合、このフィールドは vmwareClusterId に解決されます。それ以外の場合は、VMware OnPremUserCluster カスタム リソースのオブジェクト名と一致する必要があります。登録オペレーション以外では変更できません。

adminClusterMembership

string

必須。この VMware ユーザー クラスタが属する管理クラスタ。これは、管理クラスタのフリート メンバーシップの完全なリソース名です。今後、管理クラスタが独自のリソースとしてモデル化される場合は、他のリソースタイプへの参照が許可される可能性があります。

validateOnly

boolean

実際に更新せずにリクエストを検証します。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、Authentication Overview をご覧ください。