get-bucket-lifecycle
Get Bucket Lifecycle
1. 描述
GET 获取Bucket的生命周期规则。
2. 请求地址
GET /{bucket}?lifecycle
3. 请求头
请求头信息请参考【公共参数】部分。
4. 请求参数
无
5. 响应头
该响应头信息请参考【公共参数】部分。
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 覆盖 |
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
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
}
]
}
9. 错误码
该接口没有特殊错误码，错误码可以参考公共错误码