文档简介:
GET Bucket Lifecycle
此接口用于返回配置的bucket生命周期。
请求语法
GET /?lifecycle HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: date Authorization: signatureValue |
响应元素
名称 |
描述 |
LifecycleConfiguration |
容器,最多包含100个规则。 类型:容器 子节点:Rule 父节点:无 |
Rule |
生命周期规则的容器。 类型:容器 父节点:LifecycleConfiguration |
ID |
规则的唯一标示,最长255个字符。 类型:字符串 父节点:Rule |
Prefix |
指明要使用规则的对象前缀。 类型:字符串 父节点:Rule |
Status |
如果是Enabled,那么规则立即生效。如果是Disabled,那么规则不会生效。 类型:字符串 父节点:Rule |
Expiration |
描述过期动作的容器。 类型:容器 子节点:Days 父节点:Rule |
Days |
以天数来描述生命周期,值是正整数。 类型:整数 父节点:Expiration |
Date |
生成时间早于此时间的对象将被认为是过期对象。 日期必需服从ISO8601的格式,并且总是UTC的零点。 例如:2002-10-11T00:00:00.000Z。 类型:String 父节点:Expiration |
错误信息
错误码 |
描述 |
HTTP响应码 |
NoSuchLifecycleConfiguration |
The lifecycle configuration does not exist. |
404 Not Found |
请求示例
下面的GET请求从指定的bucket中获取生命周期的配置信息,OOS将生命周期的配置返回在响应体中。下面的例子显示所有以logs开头的对象将在创建后的30天到期。
GET /?lifecycle HTTP/1.1 Host: doc.oos-cn.ctyunapi.cn Date: Tue, 13 Dec 2011 17:54:50 GMT Authorization: AWS 7799e793ce4624ee7e5a:z6mvnXscCWad60vdmB9xZVVZn46= |
返回示例
HTTP/1.1 200OK x-amz-request-id: BDC4B83DF5096BBE Date:Tue, 13 Dec 2011 19:14:41 GMT Connection: close Content-Length: 267 Server: CTYUN
<?xml version="1.0" encoding="UTF-8"?> <LifecycleConfiguration xmlns="/doc/2006-03-01/"> <Rule> <ID>30-day-log-deletion-rule</ID> <Prefix>logs</Prefix> <Status>Enabled</Status> <Expiration> <Days>30</Days> </Expiration> </Rule> </LifecycleConfiguration> |