Method: projects.locations.sampleQuerySets.sampleQueries.create

SampleQuery을 만듭니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 상위 리소스 이름입니다(예: projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}).

쿼리 매개변수

매개변수
sampleQueryId

string

필수 항목입니다. SampleQuery에 사용할 ID이며, SampleQuery.name의 마지막 구성요소가 됩니다.

호출자에게 SampleQuery를 만들 권한이 없으면 SampleQuery의 존재 여부와 관계없이 PERMISSION_DENIED 오류가 반환됩니다.

이 필드는 동일한 parent을 갖는 모든 SampleQuery 간에 고유해야 합니다. 그렇지 않으면 ALREADY_EXISTS 오류가 반환됩니다.

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

요청 본문

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

응답 본문

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

승인 범위

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

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

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

IAM 권한

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

  • discoveryengine.sampleQueries.create

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