Listar vetores (Python SDK V2) - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões completas para acessar todos os recursos. Usuários RAM e funções 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 por meio de uma política do RAM ou de uma política de bucket.

API	Ação	Descrição
ListVectors	`oss:ListVectors`	Lista dados vetoriais.

Definição do método

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

list_vectors(): Chama a operação diretamente. Gerencie a paginação manualmente.
list_vectors_paginator(): Usa um paginador. O SDK gerencia automaticamente a lógica de paginação. Este é o método recomendado.

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

Parâmetros da solicitação

Parâmetro	Tipo	Descrição
request	ListVectorsRequest	Define os parâmetros da solicitação. Para mais informações, consulte ListVectorsRequest.

Valores de retorno

Tipo	Descrição
ListVectorsResult	Valor retornado pela operação. Para mais detalhes, consulte ListVectorsResult.

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

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

Valores de retorno

Tipo	Descrição
ListVectorsPaginator	Resultado da chamada ao paginador. Consulte ListVectorsPaginator para mais informações.

A documentação completa sobre o uso do paginador para listar vetores está disponível em 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 obter o código de exemplo completo sobre como listar vetores, consulte list_vectors.py.