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