Tous les produits
Search
Centre de documentation

Object Storage Service:lrb (List buckets in a region)

Dernière mise à jour :Aug 18, 2026

Utilisez la commande lrb pour récupérer les informations de base sur les buckets d'une ou plusieurs régions. Ces informations incluent les noms des buckets, les dates de création, les classes de stockage et le nombre total de buckets.

Notes d'utilisation

  • Pour lister les buckets, vous devez disposer de l'autorisation oss:ListBuckets. Pour plus d'informations, consultez la rubrique Attacher une stratégie personnalisée à un utilisateur RAM.

  • À partir de la version 1.6.16 d'ossutil, vous pouvez utiliser ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire de mettre à jour le nom binaire pour votre système d'exploitation. Pour les versions antérieures à la 1.6.16, vous devez mettre à jour le nom binaire. Pour plus d'informations, consultez la section Référence des commandes ossutil.

Format de la commande

ossutil lrb conf_file [-e <value>]

Le tableau suivant décrit les paramètres et options de la commande.

Paramètre

Description

conf_file

Pour obtenir des informations sur les buckets de plusieurs régions, spécifiez un fichier de configuration local. Dans ce fichier, saisissez l'endpoint de chaque région sur une nouvelle ligne.

-e

Pour obtenir des informations sur les buckets d'une seule région, utilisez cette option pour spécifier l'endpoint de la région.

Exemples

  • Récupérer des informations sur les buckets d'une seule région

    Récupérez les informations sur les buckets de la région Chine (Hangzhou).

    ossutil lrb -e oss-cn-hangzhou.aliyuncs.com

    Récupérez les informations sur les buckets de la région associée à l'endpoint spécifié dans le fichier de configuration d'ossutil. Pour plus d'informations sur l'endpoint dans le fichier de configuration d'ossutil, consultez la commande config.

    ossutil lrb
  • Récupérer des informations sur les buckets de plusieurs régions

    1. Créez un fichier local et configurez-y les informations d'endpoint.

      Créez un fichier local nommé localfile.txt. Dans ce fichier, saisissez les endpoints des régions pour lesquelles vous souhaitez récupérer les informations sur les buckets. Le fichier localfile.txt est configuré comme suit :

      oss-cn-hangzhou.aliyuncs.com
      oss-cn-shenzhen.aliyuncs.com
      oss-cn-shanghai.aliyuncs.com
    2. Récupérez les informations sur les buckets des régions Chine (Hangzhou), Chine (Shenzhen) et Chine (Shanghai).

      ossutil lrb localfile.txt
  • Exemple de sortie

    Si la commande aboutit, la sortie inclut le nom du bucket, la date de création, la classe de stockage, le nombre de buckets et le temps écoulé. L'exemple de sortie suivant concerne la récupération d'informations sur les buckets de plusieurs régions :

    CreationTime                                 Region    StorageClass    BucketName
    2021-07-06 14:21:09 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucket1
    2021-07-06 14:21:44 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucket2
    2021-06-16 18:32:32 +0800 CST       oss-cn-shanghai        Standard    oss://examplebucket3
    2021-06-30 16:04:41 +0800 CST       oss-cn-shanghai        Standard    oss://examplebucket4
    2021-07-07 12:33:35 +0800 CST       oss-cn-shenzhen        Standard    oss://examplebucket5
    
    Bucket Number is: 5
    0.124193(s) elapsed

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e afin de spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez l'option -i pour l'AccessKey ID et l'option -k pour l'AccessKey Secret.

Par exemple, pour récupérer les informations sur les buckets de la région Chine (Shanghai) qui appartiennent à un autre compte Alibaba Cloud, exécutez la commande suivante :

ossutil lrb -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.