list-vectors

通过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