获取桶的生命周期配置
功能介绍
获取该桶设置的生命周期配置信息。
要正确执行此操作,需要确保执行者有GetLifecycleConfiguration执行权限。默认情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。
请求消息样式
1 2 3 4 |
GET /?lifecycle HTTP/1.1 Host: bucketname.obs.region.myhuaweicloud.com Date: date Authorization: authorization |
请求消息参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头,具体参见表3。
请求消息元素
该请求消息中不使用消息元素。
响应消息样式
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 |
HTTP/1.1 status_code Date: date Content-Type: application/xml Date: date Content-Length: length <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <LifecycleConfiguration xmlns="http://obs.region.myhuaweicloud.com/doc/2015-06-30/"> <Rule> <ID>id</ID> <Filter> <And> <Prefix>prefix</Prefix> <Tag><Key>key1</Key><Value>value1</Value></Tag> <Tag><Key>key2</Key><Value>value2</Value></Tag> </And> </Filter> <Status>status</Status> <Expiration> <Date>date</Date> </Expiration> <NoncurrentVersionExpiration> <NoncurrentDays>days</NoncurrentDays> </NoncurrentVersionExpiration> <Transition> <Date>date</Date> <StorageClass>WARM</StorageClass> </Transition> <Transition> <Date>date</Date> <StorageClass>COLD</StorageClass> </Transition> <NoncurrentVersionTransition> <NoncurrentDays>30</NoncurrentDays> <StorageClass>WARM</StorageClass> </NoncurrentVersionTransition> <NoncurrentVersionTransition> <NoncurrentDays>60</NoncurrentDays> <StorageClass>COLD</StorageClass> </NoncurrentVersionTransition> </Rule> </LifecycleConfiguration> |
响应消息头
该请求的响应消息使用公共消息头,具体请参考表1。
响应消息元素
在此请求返回的响应消息体中包含的配置元素如下表1描述。
参数 |
参数类型 |
描述 |
---|---|---|
LifecycleConfiguration |
XML |
参数解释: 生命周期配置规则的Container。可以配置多条规则,LifecycleConfiguration是Rule的父节点。 取值范围: 不涉及 |
Rule |
Container |
参数解释: 具体某一条生命周期配置的Container。 取值范围: 请详见Rule参数说明。 |
参数 |
参数类型 |
描述 |
---|---|---|
Transition |
XML |
参数解释: 生命周期配置中表示转换时间和转换后对象存储级别的元素(仅针对对象的最新版本)。 取值范围: 请详见Transition参数说明。 默认取值: 不涉及 |
Expiration |
XML |
参数解释: 生命周期配置中表示过期时间的Container。 取值范围: 请详见Expiration参数说明。 |
NoncurrentVersionTransition |
XML |
参数解释: 生命周期配置中表示对象的历史版本转换时间和转换后对象存储级别的元素。 取值范围: |
NoncurrentVersionExpiration |
XML |
参数解释: 生命周期配置中表示历史版本过期时间的Container。您可以将该动作设置在已启用多版本(或暂停)的桶,让系统删除对象的满足特定生命周期的历史版本。 取值范围: |
AbortIncompleteMultipartUpload |
XML |
参数解释: 生命周期配置中表示未合并的多段任务(碎片)的过期属性Container。 取值范围: |
Filter |
XML |
参数解释: 指定具体的匹配规则,生命周期将应用于桶内匹配到的对象。可以按照对象名前缀、对象标签或者二者的组合筛选对象。 取值范围: 请详见Filter参数说明。 |
ID |
String |
参数解释: 一条规则的标识。 取值范围: 长度为0~255的字符串。 |
Prefix |
String |
参数解释: 对象名前缀,用来标识哪些对象可以匹配到当前规则。 取值范围: 长度为0~255的字符串。 |
Status |
String |
参数解释: 标识当前规则是否启用。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
Date |
String |
参数解释: 指定查询某一条规则。 取值范围: 日期格式必须为ISO8601的格式,并且为UTC的零点。 例如:2018-01-01T00:00:00.000Z,表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型,等于或晚于这个时间的对象不会被删除或转储。 |
Days |
Integer |
参数解释: 指定在对象最后修改时间的多少天后执行生命周期规则(仅针对对象的最新版本)。 取值范围: 不涉及 |
StorageClass |
String |
参数解释: 表示对象将被修改成的目标存储类别。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
Date |
String |
参数解释: 指定查询某一条规则。 取值范围: 日期格式必须为ISO8601的格式,并且为UTC的零点。 例如:2018-01-01T00:00:00.000Z,表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型,等于或晚于这个时间的对象不会被删除或转储。 |
Days |
Integer |
参数解释: 指定在对象最后修改时间的多少天后执行生命周期规则(仅针对对象的最新版本)。 取值范围: 不涉及 |
参数 |
参数类型 |
描述 |
---|---|---|
NoncurrentDays |
Integer |
参数解释: 表示对象在成为历史版本之后第几天时规则生效。单位:天。 取值范围:
|
StorageClass |
String |
参数解释: 表示对象将被修改成的目标存储类别。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
NoncurrentDays |
Integer |
参数解释: 表示对象在成为历史版本之后第几天时规则生效。单位:天。 取值范围:
|
参数 |
参数类型 |
描述 |
---|---|---|
DaysAfterInitiation |
Integer |
参数解释: 指定生命周期规则在碎片生成后多久执行过期删除操作。单位:天。 取值范围: 不涉及 |
请求示例
1 2 3 4 5 6 |
GET /?lifecycle HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 03:06:56 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:/Nof9FCNANfzIXDS0NDp1IfDu8I= |
响应示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 |
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016436BA5684FF5A10370EDB x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSEMKZSIeboCA1eAukgYOOAd7oX3ZONn Content-Type: application/xml Date: WED, 01 Jul 2015 03:06:56 GMT Content-Length: 919 <?xml version="1.0" encoding="utf-8"?> <LifecycleConfiguration> <Rule> <ID>delete-2-days</ID> <Filter> <Prefix>test/</Prefix> </Filter> <Status>Enabled</Status> <Expiration> <Days>2</Days> </Expiration> <NoncurrentVersionExpiration> <NoncurrentDays>5</NoncurrentDays> </NoncurrentVersionExpiration> <Transition> <Days>30</Days> <StorageClass>WARM</StorageClass> </Transition> <Transition> <Days>60</Days> <StorageClass>COLD</StorageClass> </Transition> <NoncurrentVersionTransition> <NoncurrentDays>30</NoncurrentDays> <StorageClass>WARM</StorageClass> </NoncurrentVersionTransition> <NoncurrentVersionTransition> <NoncurrentDays>60</NoncurrentDays> <StorageClass>COLD</StorageClass> </NoncurrentVersionTransition> </Rule> </LifecycleConfiguration> |