Method: projects.locations.bareMetalClusters.enroll

Inscreve um cluster de utilizadores bare metal existente e os respetivos pools de nós na API Anthos On-Prem num determinado projeto e localização. Através da inscrição, um cluster existente passa a ser gerido pela API Anthos On-Prem. Os recursos do GCP correspondentes são criados e espera-se que todas as modificações futuras ao cluster e/ou aos respetivos conjuntos de nós sejam realizadas através da API.

Pedido HTTP

POST https://gkeonprem.googleapis.com/v1/{parent=projects/*/locations/*}/bareMetalClusters:enroll

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O principal do projeto e a localização onde o cluster está inscrito. Formato: "projects/{project}/locations/{location}"

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

Representação JSON 
{
  "bareMetalClusterId": string,
  "localName": string,
  "adminClusterMembership": string,
  "localNamespace": string
}
Campos
bareMetalClusterId

string

Identificador do OnePlatform fornecido pelo utilizador que é usado como parte do nome do recurso. Este nome tem de ser único entre todos os clusters bare metal num projeto e numa localização, e devolve 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. Este campo é usado para suportar nomes de recursos em conflito quando inscreve clusters existentes na API. Quando não é fornecido, este campo é resolvido para o bareMetalClusterId. Caso contrário, tem de corresponder ao nome do objeto do recurso personalizado do cluster bare metal. Não é modificável fora / além da operação de inscrição.
adminClusterMembership

string

Obrigatório. O cluster de administrador ao qual este cluster de utilizadores bare metal pertence. Este é o nome do recurso completo da associação da frota do cluster de administrador. No futuro, as referências a outros tipos de recursos podem ser permitidas se os clusters de administração forem modelados como os seus próprios recursos.
localNamespace

string

Opcional. O espaço de nomes do cluster.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância de Operation.

Âmbitos de autorização

Requer o seguinte âmbito do OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para mais informações, consulte o Authentication Overview.