1. Get Bucket Lifecycle

1.1. 描述

GET 获取Bucket的生命周期规则。

1.2. 请求地址

GET /{bucket}?lifecycle

1.3. 请求头

请求头信息请参考【公共参数】部分。

1.4. 请求参数

无

1.5. 响应头

该响应头信息请参考【公共参数】部分。

1.6. 响应体

Name	Type	Description
id	String	规则ID
status	String	规则状态：Enabled启用 Disabled禁用
filter	Object	对象过滤器
expirationInDays	int	对象自动删除天数，-1表示永久不删除
abortIncompleteMultipartUpload	Object	碎片生命周期规则
transitions	List	转换规则，适用于标准存储Bucket中对象向归档Bucket转换
created	Date	规则创建时间

filter对象中的内容

Name	Type	Description
predicate	Object	对象过滤器predicate

predicate对象中的内容

Name	Type	Description
prefix	String	对象前缀，空表示作用于整个Bucket

abortIncompleteMultipartUpload对象中的内容

Name	Type	Description
daysAfterInitiation	int	碎片多少天后自动删除，-1表示永久不删除

transition对象中的内容

Name	Type	Description
days	int	最后修改时间多少天后进行转换 -1表示不转换
destinationBucketName	String	转换的目标Bucket
policy	String	策略： dup-rename 重复--重命名 dup-skip 重复-跳过 overwrite 覆盖

1.7. 请求示例

GET /bucket123?lifecycle HTTP/1.1
Host: cn-east-1.cloud-oss.com
Date: Thu, 15 Nov 2018 13:27:48 GMT
Nonce: 5e72e157-f4e3-4180-9062-7c7127939faa
Authorization: YCS1-HMAC-SHA1 Credential=5adb2538-9333-4024-b757-e095fc609a84,
SignedHeaders=date;nonce;version, Signature=5KmNSmZ7/vlWNti0cgNpJFiQNMY=
Version: 2018-10-30

1.8. 返回示例

{
    "rules": [
        {
            "id": "ed81e541-95fe-4011-bcab-591f8558c0b2_1605527901234",
            "status": "Enabled",
            "filter": {
                "predicate": {
                    "prefix": "tag1/"
                }
            },
            "expirationInDays": 1,
            "abortIncompleteMultipartUpload": {
                "daysAfterInitiation": 10
            },
            "created": 1605527901234
        },
        {
            "id": "3b5cdac9-9868-4583-98d1-380f26ea9304_1605528076266",
            "status": "Enabled",
            "filter": {
                "predicate": {
                    "prefix": "tag2/"
                }
            },
            "expirationInDays": 1,
            "abortIncompleteMultipartUpload": {
                "daysAfterInitiation": 2
            },
            "created": 1605528076266
        }
    ]
}

1.9. 错误码

该接口没有特殊错误码，错误码可以参考公共错误码

Get Bucket Lifecycle Configuration