Todos os produtos
Search
Central de documentação

Object Storage Service:list-bucket-inventory

Última atualização: Sep 24, 2026

Consulta todos os inventários de um bucket.

Notas de uso

  • Por padrão, uma conta Alibaba Cloud tem permissão para listar inventários específicos de um bucket. Para usar um usuário RAM ou o Security Token Service (STS) para consultar os inventários de um bucket, você deve ter a permissão oss:ListBucketInventory. Para mais informações, consulte Attach a custom policy to a RAM user.

  • É possível consultar até 100 inventários em uma única solicitação. Para consultar mais de 100 inventários, envie várias solicitações e use o token retornado em cada solicitação como parâmetro para a próxima.

Sintaxe do comando

ossutil api list-bucket-inventory --bucket value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket cujo inventário você deseja consultar.

--continuation-token

string

O token a partir do qual a operação de listagem começa.

Nota
  • O comando list-bucket-inventory corresponde à operação ListBucketInventory. Para obter mais informações sobre os parâmetros da operação ListBucketInventory, consulte ListBucketInventory.

  • Para mais detalhes sobre as opções globais de linha de comando compatíveis, consulte Global command-line options.

Exemplos

  • Execute o comando a seguir para consultar todos os inventários em um bucket chamado examplebucket:

    ossutil api list-bucket-inventory --bucket examplebucket
  • Para consultar todos os inventários de um bucket chamado examplebucket e exibi-los no formato JSON, execute este comando:

    ossutil api list-bucket-inventory --bucket examplebucket --output-format json
  • Para consultar todos os inventários de um bucket chamado examplebucket e exibi-los no formato YAML, utilize o seguinte comando:

    ossutil api list-bucket-inventory --bucket examplebucket --output-format yaml
  • Para consultar todos os inventários cujos nomes vêm depois de CgJiYw123 em ordem alfabética em um bucket chamado examplebucket, execute o comando abaixo:

    ossutil api list-bucket-inventory --bucket examplebucket --continuation-token CgJiYw123