put-bucket-lifecycle

Put Bucket Lifecycle

1. 描述

为Bucket配置生命周期规则。

2. 请求地址

PUT /{bucket}?lifecycle

3. 请求头

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

4. 请求参数

Name Type Description Required
id String 规则ID
status String 规则状态:Enabled启用 Disabled禁用
filter Object 对象过滤器
expirationInDays int 对象自动删除天数,-1表示永久不删除 否(expirationInDays和abortIncompleteMultipartUpload至少有其中一项)
abortIncompleteMultipartUpload Object 碎片生命周期规则
transitions List 转换规则,适用于标准存储Bucket中对象向归档Bucket转换

filter对象中的内容

Name Type Description Required
predicate Object 对象过滤器predicate

predicate对象中的内容

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

abortIncompleteMultipartUpload对象中的内容

Name Type Description Required
daysAfterInitiation int 碎片多少天后自动删除

transition对象中的内容

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

5. 请求示例

PUT /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

6. 返回示例

{
    "configuration": {
        "rules": [
            {
                "status": "Enabled",
                "filter": {
                    "predicate": {
                        "prefix": "tag1/"
                    }
                },
                "expirationInDays": 1,
                "abortIncompleteMultipartUpload": {
                    "daysAfterInitiation": 10
                }
            },
            {
                "status": "Enabled",
                "filter": {
                    "predicate": {
                        "prefix": "tag2/"
                    }
                },
                "expirationInDays": 1,
                "abortIncompleteMultipartUpload": {
                    "daysAfterInitiation": 2
                }
            }
        ]
    }
}

7. 错误码

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

个结果匹配 ""

    无结果匹配 ""