Method: projects.locations.collections.dataStores.controls.create

컨트롤을 만듭니다.

기본적으로 하나의 데이터 스토어에는 최대 1,000개의 컨트롤이 허용됩니다. 이 한도를 조정하도록 요청을 제출할 수 있습니다. 생성하려는 Control이 이미 존재하는 경우 ALREADY_EXISTS 오류가 반환됩니다.

HTTP 요청

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/dataStores/*}/controls

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

경로 파라미터

파라미터
parent

string

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

쿼리 파라미터

파라미터
controlId

string

필수 항목. 컨트롤에 사용할 ID이며, 컨트롤의 리소스 이름에서 마지막 구성 요소가 됩니다.

이 값은 1~63자(영문 기준) 사이여야 합니다. 유효한 문자는 /[az][0-9]-/입니다.

요청 본문

요청 본문에 Control의 인스턴스가 포함됩니다.

응답 본문

성공한 경우 응답 본문에 새로 생성된 Control의 인스턴스가 포함됩니다.

승인 범위

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

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

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

IAM 권한

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

  • discoveryengine.controls.create

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