Method: projects.locations.vmwareClusters.enroll

Inscribe un clúster de usuario de VMware existente y sus grupos de nodos en la API de Anthos On-Prem dentro de un proyecto y una ubicación determinados. A través de la inscripción, un clúster existente se convertirá en administrado por la API de Anthos On-Prem. Se crearán los recursos de GCP correspondientes y se espera que todas las modificaciones futuras del clúster o 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 usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
Campos
vmwareClusterId

string

Es el identificador de OnePlatform que proporcionó el usuario y que se usa como parte del nombre del recurso. Debe ser único entre todos los clústeres de GKE local en un proyecto y una ubicación, y se mostrará un error 409 si el clúster ya existe.

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

string

Opcional. Es el nombre del objeto del recurso personalizado OnPremUserCluster de VMware en el clúster de administrador asociado. Este campo se usa para admitir nombres de recursos en conflicto cuando se inscriben clústeres existentes en la API. Si no se proporciona, este campo se resolverá en vmwareClusterId. De lo contrario, debe coincidir con el nombre del objeto del recurso personalizado VMware OnPremUserCluster. No se puede modificar fuera o después de la operación de inscripción.
adminClusterMembership

string

Obligatorio. El clúster de administrador al que pertenece este clúster de usuario de VMware. Este es el nombre completo del recurso de la membresía de 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 administración se modelan como sus propios recursos.
validateOnly

boolean

Valida la solicitud sin realizar ninguna actualización.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

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