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

对象存储(KS3)

查看更多结果

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

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

最近更新时间：2024-01-17 10:25:30

描述

此GET操作返回Bucket的lifecyle配置, 即描述各条Rule的一个xml。使用此接口，您需要是Bucket的所有者或者具有获取生命周期管理规则的权限，即ks3:GetBucketLifecycle。

请求

语法

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

注意：

请求参数

本接口不使用请求参数。

请求头部

只使用常用请求头部。获取更多信息，请点击常用请求头部。

请求内容

该接口不使用请求内容。

响应

响应头部

只带有常用响应头部。获取更多信息，请点击常用响应头部。

响应内容

返回一个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，执行该Rule Disabled，忽略该Rule	是
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（控制台使用aws sdk，不支持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-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状态码	描述
NoSuchLifecycleConfiguration	404 Not Found	Bucket没有配置生命周期规则。

文档导读

上一篇：PUT Bucket Lifecycle

下一篇：DELETE Bucket Lifecycle

纯净模式常规模式

纯净模式

点击可全屏预览文档内容