Method: projects.locations.memberships.create

Crea una nuova appartenenza.

Attualmente è supportato solo per i cluster GKE su Google Cloud. Per registrare altri cluster, segui le istruzioni all'indirizzo https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. L'elemento principale (progetto e località) in cui verranno creati gli abbonamenti. Specificato nel formato projects/*/locations/*.

L'autorizzazione richiede la seguente autorizzazione IAM per la risorsa specificata parent:

  • gkehub.memberships.create

I parametri di ricerca

Parametri
membershipId

string

Obbligatorio. ID scelto dal cliente per l'appartenenza. membershipId deve essere un'etichetta DNS valida conforme a RFC 1123:

  1. Lunghezza massima: 63 caratteri
  2. Deve essere composto da caratteri alfanumerici minuscoli o -
  3. Deve iniziare e terminare con un carattere alfanumerico

che può essere espressa con l'espressione regolare: [a-z0-9]([-a-z0-9]*[a-z0-9])?, con una lunghezza massima di 63 caratteri.
requestId

string

Facoltativo. Un ID richiesta per identificare le richieste. Specifica un ID richiesta univoco in modo che, se devi ritentare la richiesta, il server saprà che la richiesta è già stata completata. Il server lo garantirà per almeno 60 minuti dopo la prima richiesta.

Ad esempio, prendi in considerazione una situazione in cui effettui una richiesta iniziale e la richiesta scade. Se effettui di nuovo la richiesta con lo stesso ID richiesta, il server può verificare se è stata ricevuta l'operazione originale con lo stesso ID richiesta e, in questo caso, ignorerà la seconda richiesta. Questo impedisce ai client di creare accidentalmente impegni duplicati.

L'ID richiesta deve essere un UUID valido, ad eccezione del fatto che un UUID zero non è supportato (00000000-0000-0000-0000-000000000000).

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Membership.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.