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, isso só é compatível com 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/v1beta1/{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.