Method: projects.locations.vmwareClusters.enroll

特定のプロジェクトとロケーション内の Anthos On-Prem API に、既存の VMware ユーザー クラスタとそのノードプールを登録します。登録により、既存のクラスタは 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 をご覧ください。