查询bucket生命周期管理配置
更新时间:2022-08-24
接口描述
该接口用于获取指定bucket的生命周期管理规则。
请求结构
GET /v1/bos/bucket/lifecycle/{bucketId} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
---|---|---|---|---|
bucketId | String | 是 | URL参数 | Bucket的ID,全局唯一,由系统自动生成,由“bkt-” 和随机字符串组成 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
ruleList | LifecycleConfiguration | 生命周期管理规则列表 |
错误码
请参照错误返回章节的内容。
请求示例
GET https://bec.baidubce.com/v1/bos/bucket/lifecycle/bkt-vdncteis HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"ruleList": [
{
"id": "test2",
"status": "Enabled",
"prefix": "test/",
"expirationInDays": 1,
"expirationDate": null
},
{
"id": "test3",
"status": "Enabled",
"prefix": "test2/",
"expirationInDays": -1,
"expirationDate": "2021-05-22T00:00:00Z"
}
]
}
Model
LifecycleConfiguration
参数名称 | 类型 | 描述 |
---|---|---|
ruleList | List<BucketRule> | 生命周期管理规则列表 |
BucketRule
参数名称 | 类型 | 描述 |
---|---|---|
id | String | 规则ID,同一配置内不能重复 |
status | String | 规则状态,可选值:Enabled,Disabled |
prefix | String | 文件名前缀,规则会匹配bucket内符合此前缀的所有文件。同一配置内前缀不能重复。为空(“”)时,对整个bucket生效,以“/”结尾则对部分路径生效 |
expirationInDays | int | 过期删除天数(与expirationDate不可同时设置) |
expirationDate | Date | 指定日期删除(与expirationInDays不可同时设置) |