Method: projects.locations.global.memberships.initializeHub

このプロジェクトのハブを初期化します。これには、デフォルトのハブ サービス アカウントとハブ Workload Identity プールの作成が含まれます。 初期化は省略可能です。最初のメンバーシップが作成されると自動的に実行されます。

これらのリソースがないと最初のメンバーシップを登録できない場合は、memberships.initializeHub を呼び出します。一般的な例としては、Hub サービス アカウントに別のプロジェクトへのアクセス権を付与します。この場合、最初にアカウントを作成する必要があります。

HTTP リクエスト

POST https://gkehub.googleapis.com/v1alpha2/{project=projects/*/locations/global/memberships}:initializeHub

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

パスパラメータ

パラメータ
project

string

必須。初期化する Hub(projects/*/locations/*/memberships/* 形式)。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

memberships.initializeHub メソッドのレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "serviceIdentity": string,
  "workloadIdentityPool": string
}
フィールド
serviceIdentity

string

Hub のデフォルト サービス ID の名前。次の形式で指定します。

service-<project-number>@gcp-sa-gkehub.iam.gserviceaccount.com

サービス アカウントには Hub プロジェクトの roles/gkehub.serviceAgent があります。

workloadIdentityPool

string

この Hub に登録されている Workload Identity 対応クラスタに使用される Workload Identity プール。形式: <project-id>.hub.id.goog

認可スコープ

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

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

詳細については、認証の概要をご覧ください。