Method: projects.locations.dataStores.create

指定されたプロジェクトとロケーションに新しい DataStore を作成します。

DataStore のバッキング コレクション(DataStore.collection_name を参照)が作成されます。その ID を持つコレクションがすでに存在する場合(たとえば、同じ ID を持つ以前の DataStore が backingCollectionDeleted なしで削除されたときに保持されたコレクションなど)、リクエストは FAILED_PRECONDITION で失敗します。

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 で受信していたかどうかを確認できます。受信していた場合は、2 回目のリクエストは無視されます。これにより、クライアントが重複するコミットを誤って作成することを防ぐことができます。

リクエスト ID は有効な UUID でなければなりません。ただし、ゼロ UUID(00000000-0000-0000-0000-000000000000)はサポートされていません。

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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