全部產品
Search
文件中心

Object Storage Service:list-vectors

更新時間:Sep 24, 2025

通過list-vectors命令列舉索引中的所有向量資料。

許可權說明

阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權,需要阿里雲帳號或帳號管理員通過RAM PolicyBucket Policy授予操作許可權。

API

Action

說明

ListVectors

oss:ListVectors

列舉向量資料。

命令格式

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

參數說明

參數

類型

說明

--bucket

string

向量Bucket名稱。

--index-name

string

索引名稱。

--max-results

int

每次返回的最大結果數,預設值500。

  • 最大為1000

  • 總資料大小不超過1MB

--next-token

string

查詢憑證(Token),取值為上一次命令返回的nextToken參數值。參數長度為1~512位元組。

--return-data

/

是否返迴向量資料,留空或設定為 true 均表示開啟。

--return-metadata

/

是否返回中繼資料,留空或設定為 true 均表示開啟

--segment-count

int

並行度,最大為16。串列時,設定為1。

--segment-index

int

分段的index,必須小於segment-count。

說明

使用樣本

  • 列舉名為 examplebucket 的向量Bucket中索引名為index下的所有向量。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index
  • 列舉名為 examplebucket 的向量Bucket中索引名為index下的前100個向量。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --max-results 100
  • 列舉名為 examplebucket 的向量Bucket中索引名為index且從指定token開始的向量。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --next-token example
  • 列舉名為 examplebucket 的向量Bucket中索引名為index下的所有向量,最大預設返回500個。

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-data
  • 列舉名為 examplebucket 的向量Bucket中索引名為index下的所有向量,且返迴向量中繼資料。

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