如何查询对象级别保留策略-对象存储(OSS)-阿里云帮助中心

您可以通过API级命令查询单个Object的保留策略信息，包括保留模式和保留截止日期。

注意事项

要查询对象保留策略，您必须有oss:GetObjectRetention权限。具体操作，请参见为RAM用户授予自定义的权限策略。
如果Object未设置独立的保留策略，调用此命令将返回NoSuchObjectRetention错误。此时Object可能继承了Bucket的默认保留策略，可通过get-bucket-object-worm-configuration命令查询Bucket的默认保留策略。

命令格式

ossutil api get-object-retention --bucket value --key value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--key	string	Object完整路径。
--version-id	string	Object的版本号。如果不指定，则默认查询Object当前版本的保留策略。

说明

get-object-retention命令对应API接口GetObjectRetention。关于API中的具体参数含义，请参见GetObjectRetention。

使用示例

查询存储空间examplebucket中对象exampleobject的保留策略。

ossutil api get-object-retention --bucket examplebucket --key exampleobject

查询对象保留策略，以JSON格式显示。

ossutil api get-object-retention --bucket examplebucket --key exampleobject --output-format json

查询对象保留策略，以YAML格式显示。

ossutil api get-object-retention --bucket examplebucket --key exampleobject --output-format yaml

查询对象指定版本的保留策略。

ossutil api get-object-retention --bucket examplebucket --key exampleobject --version-id CAEQHBiBgMC1qpjd0BYiIDQ5Y2E2ZDFkZDI1NDRlMzk5MDNlMjAxNjhhNzVh****