金山云-文档中心-GET Bucket Lifecycle

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

生命周期（Lifecycle）

GET Bucket Lifecycle

最近更新时间：2024-09-05 11:31:17

描述

使用该接口将返回Bucket的生命周期配置,。使用此接口，您需要是Bucket的所有者或者具有ks3:GetBucketLifecycle权限。

请求

语法

GET /?lifecycle HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意：

请求参数

本接口不使用请求参数。

请求头部

该接口仅使用常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

该接口除了返回常用响应头外，还返回以下响应头。

名称	描述
x-kss-allow-same-action-overlap	指定生命周期规则是否允许前缀重叠。类型：String 合法值：true、false。true表示允许前缀重叠，false表示不允许前缀重叠。规则冲突生效说明详见文档：生命周期管理。

名称

描述

x-kss-allow-same-action-overlap

指定生命周期规则是否允许前缀重叠。

类型：String
合法值：true、false。true表示允许前缀重叠，false表示不允许前缀重叠。

规则冲突生效说明详见文档：生命周期管理。

响应内容

返回XML中的参数如下所示：

名称	描述	是否必选
LifecycleConfiguration	包含一堆Rule的容器, 一个Bucket最多1000条Rule。类型：Container 子节点: Rule- 父节点：无	是
Rule	包含一条规则的容器。类型: Container 子节点：ID, Filter, Status, Expiration 父节点：LifecycleConfiguration	是
ID	Rule的唯一标识, 一个Bucket内ID不能重复。ID长度<=255字符，注意是UTF-8编码字符，不是字节。类型：String 子节点：无父节点：Rule	是
Filter	规定前缀，一个Rule只能有一个Filter, 不同Rule的Prefix不能冲突。类型：Container 子节点：Prefix 父节点：Rule	否
And	对象筛选器中的一个子集，指定Tag时需要此元素。包括同时指定Prefix和Tag筛选，以及指定一个或多个Tag筛选。类型：Container 子节点：Prefix, Tag 父节点：Filter	否
Prefix	符合这个前缀的Object才会被删。一个Rule只能有一个Filter和一个Prefix。类型：String 子节点：无父节点：Filter	否
Tag	标签集合，最多支持10个标签。类型：Container 子节点：Key, Value 父节点：And	否
Key	标签的 Key，长度不超过128字节，支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。类型：String 子节点：无父节点：Tag	否
Value	标签的 Value，长度不超过256字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、正斜线、反斜线。类型：String 子节点：无父节点：Tag	否
Status	是否执行Rule。类型：String 子节点：无父节点：Rule 取值：Enabled、Disabled。Enabled表示开启规则，Disabled表示关闭规则	是
Expiration	规定对应的Object何时被删。类型：Container 子节点：Days，Date 父节点：Rule	否
Days	规定一个正数，对应Object在last modify多少天之后被删。类型：正整数子节点：无父节点：Expiration，Transition	是，如果没有Date
Date	last modify day<这个数的Object被删。必须是ISO 8601格式的北京时间。时分秒必须填0，即必须是0点。类型：String 子节点：无父节点: Expiration，Transition	是，如果没有Days
Transition	指定Object在有效生命周期中，何时将对象转储为IA或者Archive存储类型。类型：Container 子节点: Days，Date，StorageClassg 父节点：Rule	否
StorageClass	指定对象转储到目标存储类型。取值：STANDARD_IA、ARCHIVE 子节点：无父节点：Transition	否，如果Transition有的话，则必须包含。
AbortIncompleteMultipartUpload	生命周期配置中表示未完成分块上传的过期属性。类型：Container 父节点：Rule 子节点：DaysAfterInitiation	否
DaysAfterInitiation	在分块上传任务初始化时间指定多少天之后必须完成上传，否则删除。父节点：AbortIncompleteMultipartUpload	否

示例

请求示例

GET /?lifecycle HTTP/1.1
Host: ks3-example.ks3-cn-beijing.ksyuncs.com
Date: Wed, 01 Mar 2016 12:00:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Connection: keep-alive
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: KS3
x-kss-allow-same-action-overlap: true
x-kss-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****

<LifecycleConfiguration>
    <Rule>
        <ID>id1</ID>
        <Filter>
            <Prefix>documents/</Prefix>
        </Filter>
        <Status>Enabled</Status>
        <Transition>
            <Days>100</Days>
            <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
    </Rule>
    <Rule>
        <ID>id2</ID>
        <Filter>
            <Prefix>logs/</Prefix>
        </Filter>
        <Status>Enabled</Status>
        <Expiration>
            <Days>10</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

错误码

HTTP状态码	错误码	描述
404 Not Found	NoSuchLifecycleConfiguration	Bucket没有配置生命周期规则。

文档导读

上一篇：PUT Bucket Lifecycle

下一篇：DELETE Bucket Lifecycle

纯净模式常规模式

纯净模式

点击可全屏预览文档内容