Method: projects.locations.memberships.create

Solicitação HTTP
Parâmetros de caminho
Parâmetros de consulta
Corpo da solicitação
Corpo da resposta
Escopos de autorização
Exemplos
Faça um teste

Cria uma nova assinatura.

No momento, só há suporte para isso nos clusters do GKE no Google Cloud. Para registrar outros clusters, siga as instruções em https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Solicitação HTTP

POST https://gkehub.googleapis.com/v1beta/{parent=projects/*/locations/*}/memberships

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

Parâmetros de caminho

Parâmetros

Parâmetros
`parent`	`string` Obrigatório. O pai (projeto e local) em que as assinaturas serão criadas. Especificado no formato `projects//locations/`. A autorização requer a seguinte permissão do IAM no recurso especificado `parent`: `gkehub.memberships.create`

parent

string

Obrigatório. O pai (projeto e local) em que as assinaturas serão criadas. Especificado no formato projects/*/locations/*.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

gkehub.memberships.create

Parâmetros de consulta

Parâmetros

Parâmetros
`membershipId`	`string` Obrigatório. ID escolhido pelo cliente para a assinatura. `membershipId` precisa ser um rótulo DNS válido e compatível com RFC 1123: No máximo 63 caracteres Precisa conter caracteres alfanuméricos minúsculos ou `-` Ele precisa começar e terminar com um caractere alfanumérico Que pode ser expresso como o regex: `[a-z0-9]([-a-z0-9]*[a-z0-9])?`, com tamanho máximo de 63 caracteres.
`requestId`	`string` Opcional. Um ID de solicitação para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação. Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente. O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).

membershipId

string

Obrigatório. ID escolhido pelo cliente para a assinatura. membershipId precisa ser um rótulo DNS válido e compatível com RFC 1123:

No máximo 63 caracteres
Precisa conter caracteres alfanuméricos minúsculos ou -
Ele precisa começar e terminar com um caractere alfanumérico

Que pode ser expresso como o regex: [a-z0-9]([-a-z0-9]*[a-z0-9])?, com tamanho máximo de 63 caracteres.

requestId

string

Opcional. Um ID de solicitação para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos após a primeira solicitação.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).

Corpo da solicitação

O corpo da solicitação contém uma instância de Membership.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.