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

Object Storage Service:put-vector-index

最終更新日:Jun 27, 2026

put-vector-index コマンドは、ベクトルバケットにベクトルインデックスを作成します。

注意事項

  • 1 つのベクターバケットには、最大 100 個のベクトルインデックスを含めることができます。

  • PutVectorIndex API は、最大で秒間 5 リクエストをサポートします。

権限

Alibaba Cloud アカウントには、デフォルトですべての権限があります。一方、RAM ユーザーまたは RAM ロールには、デフォルトでは権限がありません。Alibaba Cloud アカウントまたは管理者が、RAM ポリシーまたはバケットポリシーを使用して、この操作の権限を付与する必要があります。

API

アクション

説明

PutVectorIndex

oss:PutVectorIndex

ベクターインデックスを作成します。

コマンド形式

ossutil vectors-api put-vector-index --bucket value --index-name value [flags]

パラメーター

パラメーター

タイプ

説明

--bucket

string

ベクトルバケットの名前です。

--data-type

string

ベクトルのデータ型です。カスタムデータ型には対応していません。デフォルト値: float32。

--dimension

int

ベクトルの次元です。値は 1~4096 の整数です。デフォルト値は 512 です。

--distance-metric

string

距離メトリックです。有効な値:

  • euclidean: ユークリッド距離 (デフォルト)

  • cosine: コサイン距離

--index-name

string

インデックスの名前です。カスタム名を指定できます。デフォルト値は空です。

  • 名前はベクトルバケット内でグローバルに一意である必要があり、長さは 1~63 文字である必要があります。

  • 名前には英字と数字のみを含めることができ、先頭は英字にする必要があります。

--metadata

string

メタデータ設定のコンテナです。非フィルタリングメタデータのみに対応しています。非フィルタリングメタデータの設定には、以下の制限があります:

  • メタデータエントリの数は 1~100 にする必要があります。

  • 各メタデータのプライマリキー名の長さは 1~63 バイトにする必要があります。

説明

使用例

  • examplebucket バケットに index という名前のインデックスを作成します。このインデックスはベクトル次元が 512 で、float32 のデータ型とユークリッド距離メトリックを使用します。

    ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean
  • examplebucket バケットに index という名前のインデックスを作成し、非フィルタリングメタデータを設定します。このインデックスはベクトル次元が 512 で、float32 のデータ型とユークリッド距離メトリックを使用します。

    ossutil vectors-api put-vector-index --bucket examplebucket --index-name index --data-type float32 --dimension 512 --distance-metric euclidean --metadata '{"nonFilterableMetadataKeys":["owner","createdBy"]}'