Method: projects.locations.dataStores.create

Crea un nuevo DataStore en un proyecto y una ubicación determinados.

La colección de respaldo del DataStore (consulta DataStore.collection_name) se crea con él. La solicitud falla con FAILED_PRECONDITION si ya existe una colección con ese ID, por ejemplo, una que se conservó cuando se borró un DataStore anterior con el mismo ID sin backingCollectionDeleted.

Solicitud HTTP

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

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Valor para el elemento superior.

Parámetros de consulta

Parámetros
dataStoreId

string

Obligatorio. Es el ID del DataStore que se creará. El ID debe tener entre 1 y 63 caracteres, y cumplir con RFC1035. Específicamente, debe tener entre 1 y 63 caracteres, y coincidir con la expresión regular [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?.
requestId

string

Es opcional. Un ID de solicitud opcional para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar la solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantizará durante, al menos, 60 minutos después de la primera solicitud.

Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera. Si vuelves a hacer la solicitud con el mismo ID, el servidor puede verificar si se recibió la operación original con el mismo ID y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.

El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de DataStore.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta Authentication Overview.