Method: projects.locations.vmwareClusters.enroll

Registra un clúster de usuario de VMware 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/*}/vmwareClusters: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 
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
Campos
vmwareClusterId

string

Identificador de OnePlatform proporcionado por el usuario que se usa como parte del nombre del recurso. Este valor debe ser único entre todos los clústeres de GKE On-Prem de un proyecto y una ubicación, y devolverá un error 409 si el clúster ya existe.

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

string

Opcional. Nombre de objeto del recurso personalizado VMware OnPremUserCluster 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 vmwareClusterId. De lo contrario, debe coincidir con el nombre de objeto del recurso personalizado VMware OnPremUserCluster. No se puede modificar fuera de la operación de registro.
adminClusterMembership

string

Obligatorio. El clúster de administrador al que pertenece este clúster de usuarios de VMware. 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.
validateOnly

boolean

Valida la solicitud sin hacer ninguna actualización.

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.