Method: projects.locations.global.memberships.initializeHub

Inicializa el concentrador en este proyecto, lo que incluye crear la cuenta de servicio de Hub predeterminada y el grupo de Workload Identity de Hub. La inicialización es opcional y ocurre de forma automática cuando se crea la primera membresía.

Se debe llamar a membresías.initializeHub cuando la primera membresía no se puede registrar sin estos recursos. Un ejemplo común es otorgar a la cuenta de servicio de Hub acceso a otro proyecto, que requiere que la cuenta primero exista.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
project

string

Obligatorio. El concentrador que se debe inicializar, en el formato projects/*/locations/*/memberships/*.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para el método memberships.initializeHub.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON 
{
  "serviceIdentity": string,
  "workloadIdentityPool": string
}
Campos
serviceIdentity

string

Nombre de la identidad del servicio predeterminada de Hub, en el siguiente formato:

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

La cuenta de servicio tiene roles/gkehub.serviceAgent en el proyecto Hub.
workloadIdentityPool

string

El grupo de identidades para cargas de trabajo que se usa para los clústeres habilitados para Workload Identity registrados en este centro. Formato: <project-id>.hub.id.goog

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.