Method: projects.locations.dataStores.list

Enumera todos los DataStore asociados al proyecto.

Solicitud HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/dataStores

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso de la rama principal, como projects/{project}/locations/{location}/collections/{collectionId}.

Si el llamador no tiene permiso para enumerar los DataStores en esta ubicación, independientemente de si existe o no este almacén de datos, se devuelve un error PERMISSION_DENIED.

Parámetros de consulta

Parámetros
pageSize

integer

Es la cantidad máxima de DataStore que se devolverán. Si no se especifica, el valor predeterminado es 10. El valor máximo permitido es 50. Los valores superiores a 50 se convertirán a 50.

Si este campo es negativo, se devuelve un INVALID_ARGUMENT.
pageToken

string

Un token de página ListDataStoresResponse.next_page_token, recibido desde una llamada a DataStoreService.ListDataStores anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a DataStoreService.ListDataStores deben coincidir con la llamada que proporcionó el token de la página. De lo contrario, se muestra un error INVALID_ARGUMENT.
filter

string

Filtra por tipo de solución . Por ejemplo: filter = 'solutionType:SOLUTION_TYPE_SEARCH'.
view

enum (DataStoreView)

Es opcional. Es la vista que se aplicará a los objetos DataStore que se muestran. Si no se especifica, el valor predeterminado es DataStoreView.DATA_STORE_VIEW_BASIC.

Además, DataStoreView.DATA_STORE_VIEW_FULL propaga DataStore.icon_uri para los almacenes de datos respaldados por conectores. La resolución de los íconos de conectores requiere búsquedas adicionales, por lo que solo se debe solicitar cuando el llamador renderiza los íconos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ListDataStoresResponse.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

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

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • discoveryengine.dataStores.list

Para obtener más información, consulta la documentación de IAM.