Method: projects.locations.bareMetalClusters.enroll

既存のベアメタル ユーザー クラスタとそのノードプールを、指定されたプロジェクトとロケーションの Anthos On-Prem API に登録します。登録により、既存のクラスタは Anthos On-Prem API で管理されるようになります。対応する GCP リソースが作成され、クラスタまたはそのノードプールに対する今後の変更はすべて API を介して実行されることが想定されます。

HTTP リクエスト

POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters:enroll

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

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

リクエストの本文

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

JSON 表現 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "localNamespace": string
}
フィールド
bareMetalClusterId

string

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

（https://tools.ietf.org/html/rfc1123）形式。
localName

string

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

string

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

string

省略可。クラスタの Namespace。

レスポンスの本文

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

認可スコープ

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

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

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