Method: projects.locations.bareMetalClusters.enroll

Registra un clúster de usuario de metal desnudo y sus grupos de nodos en la API Anthos On-Prem de un proyecto y una ubicación determinados. Al registrar un clúster, este pasará a estar gestionado por la API Anthos On-Prem. Se crearán los recursos de GCP correspondientes y se espera que todas las modificaciones futuras del clúster o de sus grupos de nodos se realicen a través de la API.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. El elemento superior del proyecto y la ubicación en los que se ha registrado el clúster. Formato: "projects/{project}/locations/{location}"

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos que presentan la siguiente estructura:

Representación JSON 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "localNamespace": string
}
Campos
bareMetalClusterId

string

Identificador de OnePlatform proporcionado por el usuario que se usa como parte del nombre del recurso. Debe ser único entre todos los clústeres de metal desnudo de un proyecto y una ubicación. Si el clúster ya existe, se devolverá un error 409.

(https://tools.ietf.org/html/rfc1123).
localName

string

Opcional. Nombre de objeto del recurso personalizado del clúster de metal desnudo en el clúster de administrador asociado. Este campo se usa para admitir nombres de recursos conflictivos al registrar clústeres en la API. Si no se proporciona, este campo se resolverá en bareMetalClusterId. De lo contrario, debe coincidir con el nombre de objeto del recurso personalizado del clúster de metal desnudo. No se puede modificar fuera de la operación de registro.
adminClusterMembership

string

Obligatorio. El clúster de administradores al que pertenece este clúster de usuarios de metal desnudo. Es el nombre completo del recurso de la pertenencia a la flota del clúster de administrador. En el futuro, es posible que se permitan referencias a otros tipos de recursos si los clústeres de administrador se modelan como recursos propios.
localNamespace

string

Opcional. Espacio de nombres del clúster.

Cuerpo de la respuesta

Si la solicitud se hace correctamente, en el cuerpo de la respuesta se incluye una instancia de Operation.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta el Authentication Overview.