更新时间:2025-08-22 GMT+08:00

获取桶的生命周期配置

功能介绍

获取该桶设置的生命周期配置信息。

要正确执行此操作,需要确保执行者有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描述。

表1 生命周期配置元素

参数

参数类型

描述

LifecycleConfiguration

XML

参数解释:

生命周期配置规则的Container。可以配置多条规则,LifecycleConfiguration是Rule的父节点。

取值范围:

不涉及

Rule

Container

参数解释:

具体某一条生命周期配置的Container。

取值范围:

请详见Rule参数说明

表2 Rule参数说明

参数

参数类型

描述

Transition

XML

参数解释:

生命周期配置中表示转换时间和转换后对象存储级别的元素(仅针对对象的最新版本)。

取值范围:

请详见Transition参数说明

默认取值:

不涉及

Expiration

XML

参数解释:

生命周期配置中表示过期时间的Container。

取值范围:

请详见Expiration参数说明

NoncurrentVersionTransition

XML

参数解释:

生命周期配置中表示对象的历史版本转换时间和转换后对象存储级别的元素。

取值范围:

请详见NoncurrentVersionTransition参数说明

NoncurrentVersionExpiration

XML

参数解释:

生命周期配置中表示历史版本过期时间的Container。您可以将该动作设置在已启用多版本(或暂停)的桶,让系统删除对象的满足特定生命周期的历史版本。

取值范围:

请详见NoncurrentVersionExpiration参数说明

AbortIncompleteMultipartUpload

XML

参数解释:

生命周期配置中表示未合并的多段任务(碎片)的过期属性Container。

取值范围:

请详见AbortIncompleteMultipartUpload参数说明

Filter

XML

参数解释:

指定具体的匹配规则,生命周期将应用于桶内匹配到的对象。可以按照对象名前缀、对象标签或者二者的组合筛选对象。

取值范围:

请详见Filter参数说明

ID

String

参数解释:

一条规则的标识。

取值范围:

长度为0~255的字符串。

Prefix

String

参数解释:

对象名前缀,用来标识哪些对象可以匹配到当前规则。

取值范围:

长度为0~255的字符串。

Status

String

参数解释:

标识当前规则是否启用。

取值范围:

  • Enabled:启用规则。
  • Disabled:停用规则。
表3 Transition参数说明

参数

参数类型

描述

Date

String

参数解释:

指定查询某一条规则。

取值范围:

日期格式必须为ISO8601的格式,并且为UTC的零点。 例如:2018-01-01T00:00:00.000Z,表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型,等于或晚于这个时间的对象不会被删除或转储。

Days

Integer

参数解释:

指定在对象最后修改时间的多少天后执行生命周期规则(仅针对对象的最新版本)。

取值范围:

不涉及

StorageClass

String

参数解释:

表示对象将被修改成的目标存储类别。

取值范围:

  • WARM:低频访问存储
  • COLD:归档存储
  • DEEP_ARCHIVE:深度归档存储
表4 Expiration参数说明

参数

参数类型

描述

Date

String

参数解释:

指定查询某一条规则。

取值范围:

日期格式必须为ISO8601的格式,并且为UTC的零点。 例如:2018-01-01T00:00:00.000Z,表示将最后修改时间早于2018-01-01T00:00:00.000Z的对象删除或转换成其他存储类型,等于或晚于这个时间的对象不会被删除或转储。

Days

Integer

参数解释:

指定在对象最后修改时间的多少天后执行生命周期规则(仅针对对象的最新版本)。

取值范围:

不涉及

表5 NoncurrentVersionTransition参数说明

参数

参数类型

描述

NoncurrentDays

Integer

参数解释:

表示对象在成为历史版本之后第几天时规则生效。单位:天。

取值范围:

  • 仅设置一种转换:最少设置1天。
  • 设置多种转换:后者时间要比前者时间最少长1天。
  • 设置多种转换:针对同一个对象的历史版本转深度归档存储时间需要晚于转归档存储时间,转归档存储时间需要晚于转低频访问存储时间。

StorageClass

String

参数解释:

表示对象将被修改成的目标存储类别。

取值范围:

  • WARM:低频访问存储
  • COLD:归档存储
  • DEEP_ARCHIVE:深度归档存储
表6 NoncurrentVersionExpiration参数说明

参数

参数类型

描述

NoncurrentDays

Integer

参数解释:

表示对象在成为历史版本之后第几天时规则生效。单位:天。

取值范围:

  • 仅设置一种转换:最少设置1天。
  • 设置多种转换:后者时间要比前者时间最少长1天。
  • 设置多种转换:针对同一个对象的历史版本转深度归档存储时间需要晚于转归档存储时间,转归档存储时间需要晚于转低频访问存储时间。
表7 AbortIncompleteMultipartUpload参数说明

参数

参数类型

描述

DaysAfterInitiation

Integer

参数解释:

指定生命周期规则在碎片生成后多久执行过期删除操作。单位:天。

取值范围:

不涉及

表8 Filter参数说明

参数

参数类型

描述

And

XML

参数解释:

表示当前多条匹配规则逻辑且的关系。用于对象名前缀和对象标签二者的组合或多个对象标签组合来匹配对象。

取值范围:

请详见And参数说明

Tag

Container

参数解释:

对象标签,用以标识带有该标签的对象,可以匹配到当前规则。

取值范围:

请详见Tag参数说明

表9 And参数说明

参数

参数类型

描述

Tag

Container

参数解释:

标签元素,用来标识哪些被打上该标签对象,可以匹配到当前规则。

取值范围:

请详见Tag参数说明

表10 Tag参数说明

参数

参数类型

描述

Key

String

参数解释:

Tag的键名。

取值范围:

键名区分大小写且必须唯一,长度为0~128的字符串,不能为空,同时不允许使用“*”、“<”、“>”、“\”、“,”、“|”、“/”、“?”、“!”、“;”等字符。

Value

String

参数解释:

Tag的键值。

取值范围:

键值区分大小写,长度为0~255的字符串,可以为空,同时不允许使用“*”、“<”、“>”、“\”、“,”、“|”、“?”、“!”、“;”等字符。

错误响应消息

此请求可能的特殊错误如下表11描述。

表11 特殊错误

错误码

描述

HTTP状态码

NoSuchLifecycleConfiguration

桶的生命周期配置不存在

404 Not Found

其余错误已经包含在表2中。

请求示例

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>