Method: projects.locations.dataStores.create

특정 프로젝트와 위치에 새 DataStore를 만듭니다.

DataStore의 지원 컬렉션(DataStore.collection_name 참고)이 함께 생성됩니다. 해당 ID를 가진 컬렉션이 이미 있는 경우 요청이 FAILED_PRECONDITION로 실패합니다. 예를 들어 동일한 ID를 가진 이전 DataStore가 backingCollectionDeleted 없이 삭제되었을 때 유지된 컬렉션이 있는 경우입니다.

HTTP 요청

POST https://vectorsearch.googleapis.com/v1beta/{parent}/dataStores

경로 매개변수

매개변수
parent

string

필수 항목. 상위 요소 값입니다.

쿼리 파라미터

파라미터
dataStoreId

string

필수 항목입니다. 만들려는 Datastore의 ID입니다. ID는 1~63자(영문 기준)여야 하며 RFC1035를 준수해야 합니다. 구체적으로 1~63자(영문 기준)여야 하며 정규 표현식 [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?와 일치해야 합니다.

requestId

string

(선택사항) 요청을 식별하는 선택적 요청 ID입니다. 요청을 다시 시도해야 하는 경우 서버가 이미 완료되었을 때 요청을 무시하도록 고유한 요청 ID를 지정합니다. 서버는 첫 번째 요청 후 최소 60분 동안 이를 보장합니다.

예를 들어 최초 요청을 수행하고 요청이 타임아웃되는 경우를 생각해 보세요. 동일한 요청 ID로 다시 요청을 수행하면 서버는 동일한 요청 ID를 가진 원래 작업이 수신되었는지 확인할 수 있으며 그럴 경우 두 번째 요청을 무시합니다. 이렇게 해서 클라이언트가 실수로 중복된 약정을 생성하지 않도록 방지합니다.

요청 ID는 유효한 UUID여야 하며, 0 UUID는 지원되지 않습니다(00000000-0000-0000-0000-000000000000).

요청 본문

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

응답 본문

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

승인 범위

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

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

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