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. 错误码

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

results matching ""

    No results matching ""