Todos os produtos
Search
Central de documentação

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

Última atualização: Sep 22, 2026

Use o comando lrb para obter informações básicas sobre buckets em uma ou mais regiões. Essas informações incluem os nomes dos buckets, horários de criação, classes de armazenamento e o número total de buckets.

Notas de uso

  • Para listar buckets, você deve ter a permissão oss:ListBuckets. Para mais informações, consulte Attach a custom policy to a RAM user.

  • No ossutil 1.6.16 ou posterior, use ossutil como o nome do binário na linha de comando. Não é necessário atualize o nome do binário para o seu sistema operacional. Para versões anteriores à 1.6.16, atualize o nome do binário. Para mais informações, consulte ossutil command reference.

Formato do comando

ossutil lrb conf_file [-e <value>]

A tabela a seguir descreve os parâmetros e as opções do comando.

Parâmetro

Descrição

conf_file

Para obter informações sobre buckets em várias regiões, especifique um arquivo de configuração local. No arquivo, insira o endpoint de cada região em uma nova linha.

-e

Para obter informações sobre buckets em uma única região, use esta opção para especifique o endpoint da região.

Exemplos

  • Obter informações sobre buckets em uma única região

    Obtenha informações sobre buckets na região China (Hangzhou).

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

    Obtenha informações sobre buckets na região associada ao endpoint especificado no arquivo de configuração do ossutil. Para mais informações sobre o endpoint no arquivo de configuração do ossutil, consulte config command.

    ossutil lrb
  • Obter informações sobre buckets em várias regiões

    1. Crie um arquivo local e configure as informações de endpoint no arquivo.

      Crie um arquivo local chamado localfile.txt. No arquivo, insira os endpoints das regiões para as quais deseja obter informações sobre os buckets. O arquivo localfile.txt tem a seguinte configuração:

      oss-cn-hangzhou.aliyuncs.com
      oss-cn-shenzhen.aliyuncs.com
      oss-cn-shanghai.aliyuncs.com
    2. Obtenha informações sobre buckets nas regiões China (Hangzhou), China (Shenzhen) e China (Shanghai).

      ossutil lrb localfile.txt
  • Saída de exemplo

    Se o comando for executado com sucesso, a saída inclui o nome do bucket, horário de criação, classe de armazenamento, número de buckets e o tempo decorrido. O exemplo de saída a seguir mostra informações sobre buckets em várias regiões:

    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

Opções comuns

Para acessar um bucket em uma região diferente, use a opção -e para especifique o endpoint. Para acessar um bucket pertencente a uma conta Alibaba Cloud diferente, use a opção -i para o AccessKey ID e a opção -k para o AccessKey secret.

Por exemplo, para obter informações sobre buckets na região China (Shanghai) que pertencem a outra conta Alibaba Cloud, execute o seguinte comando:

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

Common options.