Todos los productos
Search
Centro de documentos

Object Storage Service:list-vectors

Última actualización: Sep 24, 2026

Use el comando list-vectors para listar todos los datos vectoriales de un índice.

Permisos

Las cuentas de Alibaba Cloud tienen todos los permisos de forma predeterminada. En cambio, los usuarios y roles de Resource Access Management (RAM) no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o un administrador debe otorgarles permisos mediante una RAM policy o un bucket policy.

API

Acción

Descripción

ListVectors

oss:ListVectors

Lista los datos vectoriales.

Formato del comando

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

Parámetros

Parámetro

Tipo

Descripción

--bucket

string

Nombre del bucket de vectores.

--index-name

string

Nombre del índice.

--max-results

int

Número máximo de resultados que se devuelven en cada respuesta. El valor predeterminado es 500.

  • El valor máximo es 1000.

  • El tamaño total de los datos no puede superar 1 MB.

--next-token

string

Token de la consulta. Establezca este parámetro con el valor nextToken que devolvió el comando anterior. El token puede tener entre 1 y 512 bytes de longitud.

--return-data

/

Indica si se devuelven los datos vectoriales. Si deja este parámetro vacío o lo establece en true, se devuelven los datos vectoriales.

--return-metadata

/

Indica si se devuelven los metadatos. Si deja este parámetro vacío o lo establece en true, se devuelven los metadatos.

--segment-count

int

Grado de paralelismo. El valor máximo es 16. Para el procesamiento en serie, establezca este parámetro en 1.

--segment-index

int

Índice del segmento. El valor debe ser menor que el valor de segment-count.

Nota
  • El comando get-vectors corresponde a la operación de API GetVectors.

  • Para obtener información sobre las opciones globales de línea de comandos compatibles, consulte Global command-line options.

Ejemplos

  • Liste todos los vectores del índice index en el bucket de vectores examplebucket.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index
  • Liste los primeros 100 vectores del índice index en el bucket de vectores examplebucket.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --max-results 100
  • Liste los vectores del índice index en el bucket de vectores examplebucket, a partir de un token específico.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --next-token example
  • Liste todos los vectores del índice index en el bucket de vectores examplebucket. De forma predeterminada, se devuelve un máximo de 500 resultados.

    ossutil vectors-api list-vectors --bucket examplebucket --index-name index --return-data
  • Liste todos los vectores del índice index en el bucket de vectores examplebucket y recupere sus metadatos.

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