REST Resource: projects.locations.dataStores

리소스: DataStore

DataStore는 DataStore 수준에서 전역 설정과 구성을 캡처합니다.

JSON 표현
{
  "name": string,
  "displayName": string,
  "industryVertical": enum (IndustryVertical),
  "solutionTypes": [
    enum (SolutionType)
  ],
  "defaultSchemaId": string,
  "contentConfig": enum (ContentConfig),
  "createTime": string,
  "advancedSiteSearchConfig": {
    object (AdvancedSiteSearchConfig)
  },
  "languageInfo": {
    object (LanguageInfo)
  },
  "naturalLanguageQueryUnderstandingConfig": {
    object (NaturalLanguageQueryUnderstandingConfig)
  },
  "kmsKeyName": string,
  "cmekConfig": {
    object (CmekConfig)
  },
  "billingEstimation": {
    object (BillingEstimation)
  },
  "aclEnabled": boolean,
  "workspaceConfig": {
    object (WorkspaceConfig)
  },
  "documentProcessingConfig": {
    object (DocumentProcessingConfig)
  },
  "startingSchema": {
    object (Schema)
  },
  "healthcareFhirConfig": {
    object (HealthcareFhirConfig)
  },
  "servingConfigDataStore": {
    object (ServingConfigDataStore)
  },
  "identityMappingStore": string,
  "isInfobotFaqDataStore": boolean,
  "configurableBillingApproach": enum (ConfigurableBillingApproach)
}
필드
name

string

변경할 수 없습니다. 식별자. 데이터 스토어의 전체 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId}입니다.

이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 1,024자(영문 기준)입니다.

displayName

string

필수 항목입니다. 데이터 스토어 표시 이름입니다.

이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이 제한은 128자(영문 기준)입니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.

industryVertical

enum (IndustryVertical)

변경할 수 없습니다. 데이터 스토어가 등록하는 업종입니다.

solutionTypes[]

enum (SolutionType)

데이터 스토어가 등록되는 솔루션입니다. 각 industryVertical에 사용할 수 있는 솔루션:

  • MEDIA: SOLUTION_TYPE_RECOMMENDATIONSOLUTION_TYPE_SEARCH
  • SITE_SEARCH: SOLUTION_TYPE_SEARCH이 자동으로 등록됩니다. 다른 솔루션은 등록할 수 없습니다.
defaultSchemaId

string

출력 전용입니다. 이 데이터 저장소와 연결된 기본 Schema의 ID입니다.

contentConfig

enum (ContentConfig)

변경할 수 없습니다. 데이터 스토어의 콘텐츠 구성입니다. 이 필드를 설정하지 않으면 서버 동작은 기본적으로 ContentConfig.NO_CONTENT입니다.

createTime

string (Timestamp format)

출력 전용입니다. DataStore이 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

advancedSiteSearchConfig

object (AdvancedSiteSearchConfig)

(선택사항) 고급 사이트 검색 구성입니다.

languageInfo

object (LanguageInfo)

DataStore의 언어 정보입니다.

naturalLanguageQueryUnderstandingConfig

object (NaturalLanguageQueryUnderstandingConfig)

(선택사항) 자연어 쿼리 이해를 위한 구성입니다.

kmsKeyName

string

입력 전용입니다. 생성 시 이 데이터 스토어를 보호하는 데 사용되는 KMS 키입니다.

CMEK 조직 정책 보호를 준수해야 하는 요청에 대해 설정해야 합니다.

이 필드가 설정되고 성공적으로 처리되면 cmekConfig 필드에 표시된 대로 데이터 스토어가 KMS 키로 보호됩니다.

cmekConfig

object (CmekConfig)

출력 전용입니다. DataStore의 CMEK 관련 정보입니다.

billingEstimation

object (BillingEstimation)

출력 전용입니다. 청구를 위한 데이터 크기 추정치입니다.

aclEnabled

boolean

변경할 수 없습니다. DataStore의 데이터에 ACL 정보가 있는지 여부 true로 설정하면 소스 데이터에 ACL이 있어야 합니다. ACL은 DocumentService.ImportDocuments 메서드로 데이터를 수집할 때 수집됩니다.

DataStore에 ACL이 사용 설정된 경우 DocumentService.GetDocument 또는 DocumentService.ListDocuments를 호출하여 Document에 액세스할 수 없습니다.

현재 ACL은 PUBLIC_WEBSITE 콘텐츠 구성이 아닌 GENERIC 업종에서만 지원됩니다.

workspaceConfig

object (WorkspaceConfig)

작업공간 데이터의 데이터 스토어 유형 구성을 저장하는 구성입니다. DataStore.content_configDataStore.ContentConfig.GOOGLE_WORKSPACE로 설정된 경우 설정해야 합니다.

documentProcessingConfig

object (DocumentProcessingConfig)

문서 이해 및 보강을 위한 구성입니다.

startingSchema

object (Schema)

DataStore를 프로비저닝할 때 사용할 시작 스키마입니다. 설정하지 않으면 기본 업종별 스키마가 사용됩니다.

이 필드는 dataStores.create API에서만 사용되며 다른 API에서 사용하면 무시됩니다. 이 필드는 dataStores.create API를 비롯한 모든 API 응답에서 생략됩니다. DataStore의 스키마를 가져오려면 SchemaService.GetSchema API를 대신 사용하세요.

제공된 스키마는 스키마에 관한 특정 규칙에 따라 검증됩니다. 이 문서에서 자세히 알아보세요.

healthcareFhirConfig

object (HealthcareFhirConfig)

(선택사항) HEALTHCARE_FHIR 세로의 구성입니다.

servingConfigDataStore

object (ServingConfigDataStore)

(선택사항) DataStore 수준에서 서빙 구성을 저장합니다.

identityMappingStore

string

변경할 수 없습니다. 연결된 IdentityMappingStore의 정규화된 리소스 이름입니다. 이 필드는 THIRD_PARTY 또는 GSUITE IdP가 있는 aclEnabled DataStore에만 설정할 수 있습니다. 형식은 projects/{project}/locations/{location}/identityMappingStores/{identityMappingStore}입니다.

isInfobotFaqDataStore

boolean

(선택사항) 설정된 경우 이 데이터 스토어는 Infobot FAQ 데이터 스토어입니다.

configurableBillingApproach

enum (ConfigurableBillingApproach)

(선택사항) 구성 가능한 결제 접근 방식의 구성입니다. 다음과 같이 표시됩니다.

메서드

completeQuery

키워드 추천으로 지정된 사용자 입력을 완료합니다.

create

DataStore를 만듭니다.

delete

DataStore를 삭제합니다.

get

DataStore을 가져옵니다.

getSiteSearchEngine

SiteSearchEngine를 가져옵니다.

list

프로젝트와 연결된 모든 DataStore를 나열합니다.

patch

DataStore 업데이트