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
}
項目
bareMetalClusterId

string

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

（https://tools.ietf.org/html/rfc1123）形式で指定します。
localName

string

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

string

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

レスポンス本文

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

認可スコープ

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

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

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