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. 错误码
该接口没有特殊错误码，错误码可以参考公共错误码