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 projeto e local especificados. Com o registro, um cluster atual se torna 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 do OnePlatform fornecido pelo usuário que é usado como parte do nome do recurso. Ele precisa ser exclusivo entre todos os clusters do GKE On-Prem em um projeto e local e retornará um erro 409 se o cluster já existir.

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

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 atuais na API. Quando não fornecido, esse campo será resolvido para o vmwareClusterId. Caso contrário, ele precisará corresponder ao nome do objeto do recurso personalizado OnPremUserCluster do VMware. Não é possível modificá-lo fora / além da operação de registro.

adminClusterMembership

string

Obrigatório. O cluster de administrador a que esse cluster de usuário do VMware pertence. Esse é o nome completo do recurso da associação de 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

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.