Method: projects.locations.vmwareClusters.enroll

Registra um cluster de usuário do VMware e seus pools de nós na API Anthos On-Prem em um determinado projeto e local. Com o registro, um cluster atual passa a ser gerenciado pela API Anthos On-Prem. Os recursos correspondentes do GCP serão criados, e todas as modificações futuras no cluster e/ou nos pools de nós precisarão ser feitas 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 da OnePlatform fornecido pelo usuário e usado como parte do nome do recurso. Precisa ser exclusivo entre todos os clusters do GKE On-Prem em um projeto e local. Retornará um erro 409 se o cluster já existir.

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

localName

string

Opcional. O nome do objeto do recurso personalizado VMware OnPremUserCluster no cluster de administrador associado. Esse campo é usado para oferecer suporte a nomes de recursos conflitantes ao registrar clusters atuais na API. Quando não fornecido, esse campo será 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 / além da operação de inscrição.

adminClusterMembership

string

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

validateOnly

boolean

Valida 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 o Authentication Overview.