Method: projects.locations.collections.dataStores.create

Creates a DataStore.

DataStore is for storing Documents. To serve these documents for Search, or Recommendation use case, an Engine needs to be created separately.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource name, such as projects/{project}/locations/{location}/collections/{collection}.

Query parameters



Required. The ID to use for the DataStore, which will become the final component of the DataStore's resource name.

This field must conform to RFC-1034 standard with a length limit of 63 characters. Otherwise, an INVALID_ARGUMENT error is returned.

Request body

The request body contains an instance of DataStore.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • discoveryengine.dataStores.create

For more information, see the IAM documentation.