Method: projects.locations.vmwareClusters.enroll

Registra um cluster de usuário do VMware e os pools de nós na API Anthos On-Prem em um determinado projeto e local. Com a inscrição, um cluster existente passa a ser gerenciado pela API Anthos On-Prem. Os recursos do GCP correspondentes serão criados, e todas as modificações futuras no cluster e/ou nos pools de nós serão realizadas pela API.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O pai do projeto e do local em que o cluster está registrado. Formato: "projects/{project}/locations/{location}"

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "vmwareClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "validateOnly": boolean
}
Campos
vmwareClusterId

string

Identificador fornecido pelo usuário da OnePlatform que é usado como parte do nome do recurso. Ele precisa ser exclusivo entre todos os clusters on-prem do GKE em um projeto e local e vai retornar um 409 se o cluster já existir.

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

localName

string

Opcional. O nome do objeto do recurso personalizado OnPremUserCluster do VMware no cluster de administrador associado. Esse campo é usado para oferecer suporte a nomes de recursos conflitantes ao registrar clusters na API. Quando não fornecido, esse campo é resolvido como vmwareClusterId. Caso contrário, ele precisa corresponder ao nome do objeto do recurso personalizado VMware OnPremUserCluster. Ele não pode ser modificado fora da operação de inscrição.

adminClusterMembership

string

Obrigatório. O cluster de administrador ao qual esse cluster de usuário do VMware pertence. É o nome completo do recurso da associação da frota do cluster de administrador. No futuro, as referências a outros tipos de recursos poderão ser permitidas se os clusters de administradores forem modelados como recursos próprios.

validateOnly

boolean

Valide a solicitação sem fazer atualizações.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte Authentication Overview.