Todos os produtos
Search
Central de documentação

Object Storage Service:Listar vetores (Python SDK V2)

Última atualização: Sep 22, 2026

Use a operação ListVectors no Python SDK V2 para listar todos os vetores em um índice de vetor específico. Há suporte à paginação para percorrer grandes volumes de dados de vetores.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais para acessar todos os recursos. Usuários e funções do RAM não têm permissões por padrão. O proprietário da conta Alibaba Cloud ou um administrador deve conceder essas permissões usando uma política do RAM ou uma política do bucket.

API

Ação

Descrição

ListVectors

oss:ListVectors

Lista dados de vetores.

Definição do método

O Python SDK V2 oferece dois métodos para listar dados de vetores:

  • list_vectors(): Chama a operação diretamente. Você precisa lidar com a paginação manualmente.

  • list_vectors_paginator(): Usa um paginador. O SDK lida automaticamente com a lógica de paginação. Este é o método recomendado.

list_vectors(request: ListVectorsRequest, **kwargs) → ListVectorsResult[source]

Parâmetros da requisição

Parâmetro

Tipo

Descrição

request

ListVectorsRequest

Defina os parâmetros da requisição. Para mais informações, consulte ListVectorsRequest.

Valores de retorno

Tipo

Descrição

ListVectorsResult

O valor de retorno. Para mais informações, consulte ListVectorsResult.

Para a definição completa do método de listagem de vetores, consulte list_vectors.

# Use a paginator
list_vectors_paginator(**kwargs) → ListVectorsPaginator[source]

Valores de retorno

Tipo

Descrição

ListVectorsPaginator

O valor de retorno. Para mais informações, consulte ListVectorsPaginator.

Para a definição completa do método de listagem de vetores com um paginador, consulte list_vectors_paginator.

Código de exemplo

import argparse
import alibabacloud_oss_v2 as oss
import alibabacloud_oss_v2.vectors as oss_vectors

parser = argparse.ArgumentParser(description="list vectors sample")

parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--account_id', help='The account id.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--index_name', help='The name of the vector index.', required=True)

def main():

    args = parser.parse_args()

    # Loading credentials from the environment variables
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Using the SDK's default configuration
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider
    cfg.region = args.region
    cfg.account_id = args.account_id
    cfg.use_internal_endpoint = True  # Set this to False or remove this line to access the service over the public network.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    client = oss_vectors.Client(cfg)

    # Create a paginator for the ListVectors operation
    paginator = client.list_vectors_paginator()

    # Create a request with the bucket and index name
    request = oss_vectors.models.ListVectorsRequest(
        bucket=args.bucket,
        index_name=args.index_name
    )

    # Iterate through the pages of vectors
    for page in paginator.iter_page(request):
        for o in page.vectors:
            print(f'Vector: {o}')

if __name__ == "__main__":
    main()

Referências

Para o código de exemplo completo de listagem de vetores, consulte list_vectors.py.