Method: projects.locations.dataStores.patch

단일 DataStore의 파라미터를 업데이트합니다.

dataStores.patch, dataStores.importDocuments, dataStores.purgeDocuments는 데이터 스토어당 한 번에 하나씩 실행됩니다. 하나가 실행되는 동안 하나 더 대기할 수 있습니다. 실행 중인 작업이 완료될 때까지 추가 요청은 ABORTED로 실패합니다.

HTTP 요청

PATCH https://vectorsearch.googleapis.com/v1beta/{dataStore.name}

경로 매개변수

파라미터
dataStore.name

string

식별자. DataStore의 정규화된 리소스 이름입니다.

형식: projects/{project}/locations/{location}/dataStores/{dataStoreId}

쿼리 파라미터

파라미터
updateMask

string (FieldMask format)

(선택사항) 필드 마스크는 업데이트로 DataStore 리소스에서 덮어쓸 필드를 지정하는 데 사용됩니다. updateMask에 지정된 필드는 전체 요청이 아닌 해당 리소스를 기준으로 합니다. 마스크에 있으면 필드를 덮어씁니다. 메시지 이름을 지정하는 경로는 전체 메시지를 대체합니다. 요청에서 생략된 하위 필드는 삭제되고 processingConfig에서 기본값으로 다시 설정됩니다.

사용자가 마스크를 제공하지 않으면 요청에서 기본값이 아닌 값으로 설정된 모든 필드를 덮어씁니다. 비어 있는 상태로 전송된 메시지 (예: layoutParsingConfig: {})와 기본값으로 설정된 필드 (예: false)는 적용되지 않습니다. 대신 마스크에서 이름을 지정하세요.

displayName, description, labels, processingConfig, documentMetadataSchema 필드는 업데이트를 지원합니다. documentMetadataSchema는 전체적으로 업데이트해야 하며 (마스크 경로는 documentMetadataSchema) 속성을 추가하는 방식으로만 업데이트해야 합니다. 기존 속성은 삭제하거나 변경할 수 없습니다.

updateMask에 *가 제공되면 전체 교체가 실행됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
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를 참조하세요.