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 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,
  "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 erro 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 será 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 / 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 o Authentication Overview.