Cette rubrique explique comment utiliser OSS SDK for Python 2.0 pour répertorier tous les buckets vectoriels de votre compte Alibaba Cloud. Cette opération prend en charge la pagination.
Autorisations
Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations sur ses ressources. Les utilisateurs RAM et les rôles RAM n'ont aucune autorisation par défaut. Pour permettre à un utilisateur RAM ou à un rôle RAM d'appeler cette opération, un compte Alibaba Cloud ou un administrateur RAM doit accorder les autorisations requises via une politique RAM ou une politique de bucket.
|
API |
Action |
Description |
|
ListVectorBuckets |
|
Répertorie les buckets vectoriels. |
Définition de la méthode
OSS SDK for Python 2.0 propose deux méthodes pour répertorier les buckets vectoriels :
list_vector_buckets(): appelle directement l'opération. Vous devez gérer manuellement la pagination.list_vector_buckets_paginator(): utilise un paginateur. Le SDK gère automatiquement la logique de pagination. Cette méthode est recommandée.
# Direct call
list_vector_buckets(request: ListVectorBucketsRequest, **kwargs) → ListVectorBucketsResultParamètres de requête
|
Paramètre |
Type |
Description |
|
request |
ListVectorBucketsRequest |
Les paramètres de la requête. Pour plus d'informations, consultez ListVectorBucketsRequest |
Valeurs de retour
|
Type |
Description |
|
ListVectorBucketsResult |
La valeur de retour. Pour plus d'informations, consultez ListVectorBucketsResult |
Pour la définition complète de la méthode, consultez list_vector_buckets.
# Use a paginator
list_vector_buckets_paginator(**kwargs) → ListVectorBucketsPaginator[source]Valeurs de retour
|
Type |
Description |
|
ListVectorBucketsPaginator |
La valeur de retour. Pour plus d'informations, consultez ListVectorBucketsPaginator |
Pour la définition complète de la méthode utilisant un paginateur, consultez list_vector_buckets_paginator.
Exemple de code
L'exemple de code suivant utilise un paginateur pour répertorier tous les buckets vectoriels. Le SDK gère automatiquement les requêtes de pagination, ce qui simplifie le code.
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()Références
Pour l'exemple de code complet permettant de répertorier les buckets vectoriels, consultez list_vector_buckets.py.