Listar vector buckets com o OSS SDK for Python 2.0 - Object Storage Service: Central de Documentação do Alibaba Cloud

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais sobre seus recursos. Usuários e funções RAM não possuem permissões por padrão. Para permitir que um usuário ou função RAM execute esta operação, uma conta Alibaba Cloud ou um administrador RAM deve conceder as permissões necessárias por meio de uma política RAM ou de uma política de bucket.

API	Ação	Descrição
ListVectorBuckets	`oss:ListVectorBuckets`	Lista vector buckets.

Definição do método

O OSS SDK for Python 2.0 oferece dois métodos para listar vector buckets:

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

# Direct call
list_vector_buckets(request: ListVectorBucketsRequest, **kwargs) → ListVectorBucketsResult

Parâmetros da solicitação

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

Valores de retorno

Tipo	Descrição
ListVectorBucketsResult	Valor de retorno. Para mais informações, consulte ListVectorBucketsResult

Para obter a definição completa do método, consulte list_vector_buckets.

# Use a paginator
list_vector_buckets_paginator(**kwargs) → ListVectorBucketsPaginator[source]

Valores de retorno

Tipo	Descrição
ListVectorBucketsPaginator	Valor de retorno. Para mais informações, consulte ListVectorBucketsPaginator

Para obter a definição completa do método com paginador, consulte list_vector_buckets_paginator.

Código de exemplo

O exemplo a seguir usa um paginador para listar todos os vector buckets. O SDK gerencia automaticamente as solicitações de paginação, simplificando o código.

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

parser = argparse.ArgumentParser(description="list vector buckets 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)

def main():

    args = parser.parse_args()

    # Loading credentials values 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  # To access OSS over the public network, set this parameter to False or delete this line.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    client = oss_vectors.Client(cfg)

    # Create the Paginator for the ListVectorBuckets operation
    paginator = client.list_vector_buckets_paginator()

    # Iterate through the vector bucket pages
    for page in paginator.iter_page(oss_vectors.models.ListVectorBucketsRequest(
        )
    ):
        for o in page.buckets:
            print(f'Bucket: {o.name}, {o.location}')

if __name__ == "__main__":
    main()

Referências

Para obter o código de exemplo completo de listagem de vector buckets, consulte list_vector_buckets.py.