Method: projects.locations.collections.engines.controls.list

상위 DataStore별로 모든 컨트롤을 나열합니다.

HTTP 요청

GET https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*/collections/*/engines/*}/controls

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 데이터 스토어 리소스 이름입니다. 형식: projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} 또는 projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}

쿼리 매개변수

매개변수
pageSize

integer

(선택사항) 반환할 결과의 최대 수입니다. 지정하지 않으면 기본값은 50입니다. 허용되는 최댓값은 1000입니다.

pageToken

string

(선택사항) 이전 controls.list 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

filter

string

(선택사항) 목록 결과에 적용할 필터입니다. 지원되는 기능:

  • filter가 설정되지 않은 경우 상위 브랜치 아래의 모든 제품을 나열합니다. 현재 이 필드는 지원되지 않습니다.

요청 본문

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

응답 본문

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

승인 범위

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

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

자세한 내용은 Authentication Overview를 참조하세요.

IAM 권한

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

  • discoveryengine.controls.list

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