Method: projects.locations.setUpDataConnector

Collection를 만들고 DataConnector를 설정합니다. 설정 후 DataConnector를 중지하려면 CollectionService.DeleteCollection 메서드를 사용합니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}:setUpDataConnector

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. Collection의 상위 요소(projects/{project}/locations/{location} 형식)입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "collectionId": string,
  "collectionDisplayName": string,
  "dataConnector": {
    object (DataConnector)
  }
}
필드
collectionId

string

필수 항목입니다. Collection에 사용할 ID이며, Collection의 리소스 이름에서 마지막 구성요소가 됩니다. 새 CollectionDataConnector 설정의 일부로 생성됩니다. DataConnectorCollection 아래의 싱글톤 리소스로, Collection의 모든 DataStore를 관리합니다.

이 필드는 RFC-1034 표준을 준수해야 하며 길이 제한은 63자(영문 기준)입니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

collectionDisplayName

string

필수 항목입니다. Collection의 표시 이름입니다.

사람이 읽을 수 있어야 하며, 콘솔 대시보드에서 컬렉션을 표시하는 데 사용됩니다. 길이 제한이 1,024자인 UTF-8로 인코딩된 문자열입니다.

dataConnector

object (DataConnector)

필수 항목입니다. 새로 만든 Collection에서 초기화할 DataConnector입니다.

응답 본문

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

승인 범위

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

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

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

IAM 권한

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

  • discoveryengine.locations.setUpDataConnector

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