list-bucket-inventory

list-bucket-inventory接口用于查看某个存储空间(Bucket)中的所有清单(Inventory)任务。

注意事项

  • 阿里云账号默认拥有列举Bucket指定清单任务的权限。如果您需要通过RAM用户或者STS的方式进行查看,您必须拥有oss:ListBucketInventory权限。具体操作,请参见为RAM用户授权自定义的权限策略

  • 单次请求最多可获取100条清单配置项内容。若需获取超过100条清单配置项,则需发送多次请求,并保留相应的token,作为下一次请求的参数。

命令格式

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

参数

类型

说明

--bucket

string

Bucket的名称。

--continuation-token

string

指定list操作需要从此token开始。

说明

使用示例

  • 获取存储空间examplebucket中的所有清单任务。

    ossutil api list-bucket-inventory --bucket examplebucket
  • 获取存储空间examplebucket中的所有清单任务,以JSON格式显示。

    ossutil api list-bucket-inventory --bucket examplebucket --output-format json
  • 获取存储空间examplebucket中的所有清单任务,以YAML格式显示。

    ossutil api list-bucket-inventory --bucket examplebucket --output-format yaml
  • 获取存储空间examplebucket中从 CgJiYw123 开始的所有清单任务。

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