Method: projects.locations.dataStores.list

프로젝트와 연결된 모든 DataStore을 나열합니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목. 상위 브랜치 리소스 이름입니다(예: projects/{project}/locations/{location}/collections/{collectionId}).

호출자에게 이 위치에 있는 DataStore를 나열할 권한이 없으면 이 데이터 스토어의 존재 여부와 관계없이 PERMISSION_DENIED 오류가 반환됩니다.

쿼리 매개변수

매개변수
pageSize

integer

반환할 최대 DataStore 수입니다. 지정하지 않으면 기본적으로 10입니다. 허용되는 최댓값은 50입니다. 50을 초과하는 값은 50으로 변환됩니다.

이 필드가 음수이면 INVALID_ARGUMENT가 반환됩니다.
pageToken

string

이전 DataStoreService.ListDataStores 호출에서 받은 ListDataStoresResponse.next_page_token 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 DataStoreService.ListDataStores에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
filter

string

솔루션 유형별로 필터링합니다. 예: filter = 'solutionType:SOLUTION_TYPE_SEARCH'
view

enum (DataStoreView)

선택사항입니다. 반환된 DataStore에 적용할 뷰입니다. 지정되지 않은 경우 기본값은 DataStoreView.DATA_STORE_VIEW_BASIC입니다.

또한 DataStoreView.DATA_STORE_VIEW_FULL은 커넥터 지원 데이터 스토어의 DataStore.icon_uri를 채웁니다. 커넥터 아이콘을 확인하려면 추가 조회가 필요하므로 호출자가 아이콘을 렌더링할 때만 요청하세요.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문에 ListDataStoresResponse의 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 Authentication Overview에서 확인하세요.

IAM 권한

parent 리소스에 대해서는 다음 IAM 권한이 필요합니다.

  • discoveryengine.dataStores.list

자세한 내용은 IAM 문서를 참조하세요.