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

Object Storage Service:list-vectors

最終更新日:Nov 09, 2025

list-vectors コマンドを使用して、インデックス内のすべてのベクトルデータをリストします。

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。対照的に、Resource Access Management (RAM) ユーザーおよび RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して、権限を付与する必要があります。

API

アクション

説明

ListVectors

oss:ListVectors

ベクトルデータをリストします。

コマンドフォーマット

ossutil vectors-api list-vectors --bucket value --index-name value [flags]

パラメーター

パラメーター

タイプ

説明

--bucket

string

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

--index-name

string

インデックスの名前。

--max-results

int

各応答で返される結果の最大数。デフォルト値は 500 です。

  • 最大値は 1000 です。

  • 合計データサイズは 1 MB を超えることはできません。

--next-token

string

クエリトークン。このパラメーターを、前のコマンドで返された `nextToken` の値に設定します。トークンの長さは 1~512 バイトです。

--return-data

/

ベクトルデータを返すかどうかを指定します。このパラメーターを空にするか、true に設定すると、ベクトルデータが返されます。

--return-metadata

/

メタデータを返すかどうかを指定します。このパラメーターを空のままにするか、true に設定すると、メタデータが返されます。

--segment-count

int

並列処理の次数。最大値は 16 です。シリアル処理の場合は、このパラメーターを 1 に設定します。

--segment-index

int

セグメントのインデックス。値は `segment-count` の値より小さくする必要があります。

説明

  • `examplebucket` ベクトルバケットの `index` インデックス内のすべてのベクトルをリストします。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index
  • `examplebucket` ベクトルバケットの `index` インデックス内の最初の 100 個のベクトルをリストします。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --max-results 100
  • `examplebucket` ベクトルバケットの `index` インデックス内のベクトルを、指定されたトークンから開始してリストします。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --next-token example
  • `examplebucket` ベクトルバケットの `index` インデックス内のすべてのベクトルをリストします。デフォルトでは、最大 500 件の結果が返されます。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-data
  • `examplebucket` ベクトルバケットの `index` インデックス内のすべてのベクトルをリストし、そのメタデータを取得します。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-metadata