Method: projects.locations.dataStores.create

DataStore を作成します。

DataStore は Documents を保存するためのものです。これらのドキュメントを検索または推奨事項のユースケースで使用するには、Engine を別途作成する必要があります。

HTTP リクエスト

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

この URL では gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。親リソース名(projects/{project}/locations/{location}/collections/{collection} など)。

クエリ パラメータ

パラメータ
dataStoreId

string

必須。DataStore に使用する ID。DataStore のリソース名の最終的なコンポーネントになります。

このフィールドは RFC-1034 標準に準拠し、長さは 63 文字以下にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

skipDefaultSchemaCreation

boolean

データストアのデフォルト スキーマの作成をスキップするかどうかを示すブール値のフラグ。デフォルトのスキーマがユースケースと互換性がないことが確実な場合にのみ、このフラグを有効にしてください。

true に設定した場合、ドキュメントを取り込む前に、データストアのスキーマを手動で作成する必要があります。

dataStore.starting_schema が指定されている場合、このフラグは指定できません。

結合パラメータ cmek_options。DataStore の CMEK オプション。このフィールドを設定すると、プロジェクトに設定されているデフォルトの CmekConfig がオーバーライドされます。cmek_options は次のいずれかになります。
cmekConfigName

string

この DataStore の保護に使用する CmekConfig のリソース名。

disableCmek

boolean

CMEK 保護のない DataStore。プロジェクトにデフォルトの CmekConfig が設定されている場合、このフィールドを設定すると、デフォルトの CmekConfig もオーバーライドされます。

リクエストの本文

リクエストの本文には DataStore のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、Authentication Overview をご覧ください。

IAM 権限

parent リソースに対する次の IAM 権限が必要です。

  • discoveryengine.dataStores.create

詳細については、IAM のドキュメントをご覧ください。