Method: projects.locations.instances.create

Créer une instance dans un projet et un emplacement donnés.

Requête HTTP

POST https://memorystore.googleapis.com/v1/{parent=projects/*/locations/*}/instances

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Ressource parente dans laquelle cette instance sera créée. Format : projects/{project}/locations/{location}

Paramètres de requête

Paramètres
instanceId

string

Obligatoire. ID à utiliser pour l'instance, qui deviendra le dernier composant du nom de ressource de l'instance.

Cette valeur est soumise aux restrictions suivantes:

  • Doit contenir entre 4 et 63 caractères
  • doit commencer par une lettre ou un chiffre ;
  • Doit être composé uniquement de lettres minuscules, de chiffres et de traits d'union
  • L'ID ne doit pas se terminer par un trait d'union
  • Doit être unique au sein d'un établissement
requestId

string

Facultatif. ID de requête facultatif 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 Instance.

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

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • memorystore.instances.create

Pour en savoir plus, consultez la documentation IAM.