Method: projects.locations.bareMetalClusters.enroll

Registra um cluster de usuário de bare metal 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/*}/bareMetalClusters: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 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string
}
Campos
bareMetalClusterId

string

Identificador fornecido pelo usuário da OnePlatform que é usado como parte do nome do recurso. Ele precisa ser exclusivo entre todos os clusters bare metal 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 do cluster bare metal 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 bareMetalClusterId. Caso contrário, ele precisa corresponder ao nome do objeto do recurso personalizado do cluster bare metal. 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 bare metal 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 administrador forem modelados como recursos próprios.

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.