Todos os produtos
Search
Central de documentação

Object Storage Service:get-bucket-inventory

Última atualização: Sep 25, 2026

Consulta inventários específicos de um bucket.

Notas de uso

Por padrão, uma conta da Alibaba Cloud tem permissões para consultar inventários específicos de um bucket. Para usar um usuário RAM ou STS nessa operação, é necessário ter a permissão oss:GetBucketInventory. Para mais informações, consulte Attach a custom policy to a RAM user.

Sintaxe do comando

ossutil api get-bucket-inventory --bucket value --inventory-id value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket cujos inventários você deseja consultar.

--inventory-id

string

O ID dos inventários que você deseja consultar.

Nota
  • O comando get-bucket-inventory corresponde à operação GetBucketInventory. Para mais informações sobre os parâmetros dessa operação, consulte GetBucketInventory.

  • Para mais informações sobre as opções globais de linha de comando com suporte, consulte Global command-line options.

Exemplos

  • Execute o comando a seguir para consultar um inventário chamado report1 no bucket examplebucket:

    ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1
  • Execute o comando a seguir para consultar um inventário chamado report1 no bucket examplebucket e exibir o inventário no formato JSON:

    ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1 --output-format json
  • Execute o comando a seguir para consultar um inventário chamado report1 no bucket examplebucket e exibir o inventário no formato YAML:

    ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1 --output-format yaml