Queries specific inventories of a bucket.
Usage notes
By default, an Alibaba Cloud account has the permissions to query specific inventories of a bucket. If you want to use a RAM user or STS to query specific inventories of a bucket, you must have the oss:GetBucketInventory permission. For more information, see Attach a custom policy to a RAM user.
Command syntax
ossutil api get-bucket-inventory --bucket value --inventory-id value [flags]
|
Parameter |
Type |
Description |
|
--bucket |
string |
The name of the bucket whose inventories you want to query. |
|
--inventory-id |
string |
The ID of the inventories that you want to query. |
-
The get-bucket-inventory command corresponds to the GetBucketInventory operation. For more information about the parameters in the GetBucketInventory operation, see GetBucketInventory.
-
For more information about supported global command-line options, see Global command-line options.
Examples
-
Run the following command to query an inventory whose name is report1 in the examplebucket bucket:
ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1 -
Run the following command to query an inventory whose name is report1 in the examplebucket bucket and display the inventory in the JSON format:
ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1 --output-format json -
Run the following command to query an inventory whose name is report1 in the examplebucket bucket and display the inventory in the YAML format:
ossutil api get-bucket-inventory --bucket examplebucket --inventory-id report1 --output-format yaml