Method: projects.locations.bareMetalClusters.enroll

Registra um cluster de usuário bare metal e os pools de nós dele 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/*}/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 o 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,
  "localNamespace": string
}
Campos
bareMetalClusterId

string

Identificador da OnePlatform fornecido pelo usuário e usado como parte do nome do recurso. Precisa ser exclusivo entre todos os clusters bare metal em um projeto e local. Retornará um 409 se o cluster já existir.

(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 atuais 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. 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 bare metal 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.
localNamespace

string

Opcional. O namespace do cluster.

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.