すべてのプロダクト
Search
ドキュメントセンター

DashVector:パーティションの作成

最終更新日:Mar 12, 2026

パーティションは、ベクトルデータをセグメント化するコレクションの論理的なサブセットです。

以下に示す HTTP API を呼び出して、DashVector コレクションにパーティションを作成します。

前提条件

開始する前に、以下を確認してください。

メソッドと URL

POST https://{Endpoint}/v1/collections/{CollectionName}/partitions

説明

この例を実行する前に:

  1. <your-api-key> をご利用の API キーに、<your-cluster-endpoint> をご利用のクラスターエンドポイントに置き換えます。

  2. quickstart という名前のコレクションを作成します。詳細については、「コレクションの作成」の「例」セクションをご参照ください。

次のリクエストは、quickstart コレクションに shoes という名前のパーティションを作成します。

API_KEY="<your-api-key>"
CLUSTER_ENDPOINT="<your-cluster-endpoint>"

curl -X POST \
  -H "dashvector-auth-token: ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "shoes"
  }' \
  "https://${CLUSTER_ENDPOINT}/v1/collections/quickstart/partitions"

応答例:

{
  "request_id": "19215409-ea66-4db9-8764-26ce2eb5bb99",
  "code": 0,
  "message": ""
}

code の値が 0 の場合、パーティションが作成されたことを確認できます。

リクエストパラメーター

パラメーター

場所

必須

説明

{Endpoint}

path

str

はい

クラスターエンドポイント。これは、コンソールの「クラスターの詳細」ページで確認できます。

{CollectionName}

path

str

はい

パーティションを作成するコレクションの名前。

dashvector-auth-token

header

str

はい

API キー。

name

body

str

はい

パーティションの名前。

応答パラメーター

パラメーター

説明

code

int

ステータスコード。0 は成功を示します。詳細については、「ステータスコード」をご参照ください。

0

message

str

応答メッセージ。

success

request_id

str

一意のリクエスト ID。

19215409-ea66-4db9-8764-26ce2eb5bb99