Todos los productos
Search
Centro de documentos

Object Storage Service:lrb (listar buckets en una región)

Última actualización: Sep 22, 2026

Use el comando lrb para obtener información básica sobre los buckets de una o varias regiones. Esta información incluye los nombres de los buckets, las fechas de creación, las clases de almacenamiento y la cantidad total de buckets.

Notas de uso

  • Para listar buckets, necesita el permiso oss:ListBuckets. Para más información, consulte Attach a custom policy to a RAM user.

  • En ossutil 1.6.16 o versiones posteriores, puede usar ossutil como nombre del binario en la línea de comandos. No es necesario actualizar el nombre del binario según su sistema operativo. En versiones anteriores a la 1.6.16, sí debe actualizarlo. Para más información, consulte ossutil command reference.

Formato del comando

ossutil lrb conf_file [-e <value>]

A continuación se describen los parámetros y las opciones del comando.

Parámetro

Descripción

conf_file

Para obtener información sobre los buckets de varias regiones, especifique un archivo de configuración local. En dicho archivo, introduzca el endpoint de cada región en una línea nueva.

-e

Para obtener información sobre los buckets de una sola región, use esta opción e indique el endpoint correspondiente.

Ejemplos

  • Obtener información sobre los buckets de una sola región

    Obtenga información sobre los buckets de la región China (Hangzhou).

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

    Obtenga información sobre los buckets de la región asociada al endpoint especificado en el archivo de configuración de ossutil. Para más detalles sobre este endpoint, consulte config command.

    ossutil lrb
  • Obtener información sobre los buckets de varias regiones

    1. Cree un archivo local y configure la información del endpoint en él.

      Cree un archivo local llamado localfile.txt. En este archivo, introduzca los endpoints de las regiones de las que desea obtener información de buckets. El contenido de localfile.txt queda configurado de la siguiente manera:

      oss-cn-hangzhou.aliyuncs.com
      oss-cn-shenzhen.aliyuncs.com
      oss-cn-shanghai.aliyuncs.com
    2. Obtenga información sobre los buckets de las regiones China (Hangzhou), China (Shenzhen) y China (Shanghai).

      ossutil lrb localfile.txt
  • Ejemplo de salida

    Si el comando se ejecuta correctamente, la salida muestra el nombre del bucket, la fecha de creación, la clase de almacenamiento, la cantidad de buckets y el tiempo transcurrido. A continuación se muestra un ejemplo de salida al obtener información de buckets en varias regiones:

    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

Opciones comunes

Para acceder a un bucket en otra región, use -e y especifique el endpoint. Si necesita acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, utilice -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, para obtener información sobre los buckets de la región China (Shanghai) que pertenecen a otra cuenta de Alibaba Cloud, ejecute el siguiente comando:

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

Common options.