Method: projects.locations.dataStores.create

Crée un DataStore dans un projet et un emplacement donnés.

La collection de sauvegarde du datastore (voir DataStore.collection_name) est créée en même temps que lui. La requête échoue avec FAILED_PRECONDITION si une collection portant cet ID existe déjà, par exemple une collection conservée lorsqu'un datastore antérieur portant le même ID a été supprimé sans backingCollectionDeleted.

Requête HTTP

POST https://vectorsearch.googleapis.com/v1beta/{parent}/dataStores

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Valeur pour le parent.

Paramètres de requête

Paramètres
dataStoreId

string

Obligatoire. ID du datastore à créer. L'ID doit comporter entre 1 et 63 caractères, et être conforme à la norme RFC1035. Plus précisément, il doit comporter entre 1 et 63 caractères et correspondre à l'expression régulière [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?.

requestId

string

Facultatif. ID de requête facultatif permettant d'identifier les requêtes. Spécifiez un ID de requête unique pour indiquer au serveur d'ignorer la requête si vous devez la relancer alors qu'elle a déjà été traitée. Le serveur garantira cette logique pendant au moins 60 minutes après la première requête.

Imaginons que vous effectuez une requête initiale et que celle-ci expire. Si vous effectuez de nouveau la requête avec le même ID, le serveur peut vérifier si une opération initiale avec cet ID de requête a déjà été reçue et, si c'est le cas, ignorer la deuxième requête. Cela permet d'éviter que les clients ne créent accidentellement des engagements en double.

L'ID de requête doit être un UUID valide, sachant 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 DataStore.

Corps de la réponse

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

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.