Method: projects.locations.memberships.create

Crée une ressource Membership.

Cette fonctionnalité n'est actuellement disponible que pour les clusters GKE sur Google Cloud. Pour enregistrer d'autres clusters, suivez les instructions disponibles sur la page https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent (projet et emplacement) dans lequel les ressources Membership seront créées. Spécifié au format projects/*/locations/*.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • gkehub.memberships.create

Paramètres de requête

Paramètres
membershipId

string

Obligatoire. ID choisi par le client pour l'appartenance. membershipId doit être un libellé DNS valide conforme à la norme RFC 1123 :

  1. 63 caractères maximum
  2. Il doit être composé de caractères alphanumériques minuscules ou de -.
  3. Il doit commencer et se terminer par un caractère alphanumérique.

Il peut être exprimé sous la forme de l'expression régulière : [a-z0-9]([-a-z0-9]*[a-z0-9])?, d'une longueur maximale de 63 caractères.
requestId

string

Facultatif. ID de requête permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour que le serveur sache qu'il doit ignorer la requête si vous devez la retenter alors qu'elle est déjà terminée. Le serveur garantit cela pendant au moins 60 minutes après la première requête.

Par exemple, imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez à nouveau la requête avec le même ID de requête, le serveur peut vérifier si une opération d'origine ayant le même ID de requête a été reçue et, le cas échéant, ignorer la deuxième requête. Ainsi, les clients ne peuvent pas créer accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, à ceci près qu'un UUID égal à zéro (00000000-0000-0000-0000-000000000000) n'est pas accepté.

Corps de la requête

Le corps de la requête contient une instance de Membership.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.