Todos os produtos
Search
Central de documentação

Object Storage Service:list-vectors

Última atualização: Jul 03, 2026

Use o comando list-vectors para listar todos os dados vetoriais em um índice.

Permissões

As contas Alibaba Cloud têm todas as permissões por padrão. Já os usuários e funções do Resource Access Management (RAM) não possuem permissões configuradas inicialmente. A conta Alibaba Cloud ou um administrador deve conceder as permissões necessárias usando uma política do RAM ou uma política de bucket.

API

Ação

Descrição

ListVectors

oss:ListVectors

Lista dados vetoriais.

Formato do comando

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

Parâmetros

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket de vetores.

--index-name

string

Nome do índice.

--max-results

int

Número máximo de resultados retornados em cada resposta. O valor padrão é 500.

  • O valor máximo é 1000.

  • O tamanho total dos dados não pode exceder 1 MB.

--next-token

string

Token de consulta. Defina este parâmetro com o valor nextToken retornado pelo comando anterior. O token pode ter de 1 a 512 bytes.

--return-data

/

Defina se os dados vetoriais devem ser retornados. Se este parâmetro estiver vazio ou definido como true, os dados vetoriais serão incluídos na resposta.

--return-metadata

/

Defina se os metadados devem ser retornados. Se este parâmetro estiver vazio ou definido como true, os metadados serão incluídos na resposta.

--segment-count

int

Grau de paralelismo. O valor máximo é 16. Para processamento serial, defina este parâmetro como 1.

--segment-index

int

Índice do segmento. O valor deve ser menor que o valor de segment-count.

Nota

Exemplos

  • Liste todos os vetores no índice index do bucket de vetores examplebucket.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index
  • Liste os primeiros 100 vetores no índice index do bucket de vetores examplebucket.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --max-results 100
  • Liste vetores no índice index do bucket de vetores examplebucket, começando por um token específico.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --next-token example
  • Liste todos os vetores no índice index do bucket de vetores examplebucket. Por padrão, são retornados até 500 resultados.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-data
  • Liste todos os vetores no índice index do bucket de vetores examplebucket e recupere seus metadados.

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