1. Put Bucket Lifecycle
1.1. 描述
为Bucket配置生命周期规则。
1.2. 请求地址
PUT /{bucket}?lifecycle
1.3. 请求头
该请求头公共信息请参考【公共参数】部分。
1.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 覆盖 |
1.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 |
```json { "configuration": { "rules": [ { "status": "Enabled", "filter": { "predicate": { "prefix": "tag1/" } }, "expirationInDays": 1, "abortIncompleteMultipartUpload": { "daysAfterInitiation": 10 } }, { "status": "Enabled", "filter": { "predicate": { "prefix": "tag2/" } }, "expirationInDays": 1, "abortIncompleteMultipartUpload": { "daysAfterInitiation": 2 } } ] } } ``` |
1.6. 错误码
该接口没有特殊错误码,错误码可以参考公共错误码