腾讯云对象存储PUT Bucket lifecycle

功能描述

COS 支持用户以生命周期配置的方式来管理 Bucket 中 Object 的生命周期。生命周期配置包含一个或多个将应用于一组对象规则的规则集（其中每个规则为 COS 定义一个操作）。
这些操作分为以下两种：转换操作：定义对象转换为另一个存储类的时间。例如，您可以选择在对象创建30天后将其转换为低频存储（STANDARD_IA，适用于不常访问）存储类别。同时也支持将数据沉降到智能分层存储（INTELLIGENT_TIERING，访问模式不固定）和归档存储（ARCHIVE，成本更低）。具体参数查看请求示例说明中 Transition 项。过期操作：指定 Object 的过期时间。COS 将会自动为用户删除过期的 Object。

授权说明

授权策略中 action 设置为 cos:PutBucketLifecycle 。查看所有 action。

细节分析

PUT Bucket lifecycle 用于为 Bucket 创建一个新的生命周期配置。注意如果该 Bucket 已配置生命周期，使用该接口创建新的配置的同时则会覆盖原有的配置。同一条生命周期规则中不可同时支持 Days 和 Date 参数，请分成两条规则分别传入，具体请参见下文 实际案例。开启了 多 AZ 配置的存储桶，不支持将多 AZ 存储类型沉降到单 AZ 存储类型。每个存储桶最多可添加1000条生命周期规则。

请求

请求示例

PUT /?lifecycle HTTP/1.1Host: .cos..myqcloud.comContent-Length: lengthDate: GMT DateAuthorization: Auth String Content-MD5: MD5

说明Host: .cos..myqcloud.com，其中 为带 APPID 后缀的存储桶名字，例如 examplebucket-1250000000，可参阅 存储桶概览 > 基本信息 和 存储桶概述 > 存储桶命名规范 文档； 为 COS 的可用地域，可参阅 地域和访问域名 文档。Authorization: Auth String（详情请参见 请求签名 文档）。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

该 API 接口请求的请求体具体节点内容为：

<LifecycleConfiguration>    <Rule>        <ID></ID>        <Filter>            <And>                <Prefix></Prefix>                <Tag>                    <Key></Key>                    <Value></Value>                </Tag>            </And>        </Filter>        <Status></Status>        <Transition>            <Days></Days>            <StorageClass></StorageClass>        </Transition>        <NoncurrentVersionExpiration>            <NoncurrentDays></NoncurrentDays>        </NoncurrentVersionExpiration>    </Rule>    <Rule>        <ID></ID>        <Filter>            <Prefix></Prefix>        </Filter>        <Status></Status>        <Transition>            <Days></Days>            <StorageClass></StorageClass>        </Transition>        <NoncurrentVersionTransition>            <NoncurrentDays></NoncurrentDays>            <StorageClass></StorageClass>        </NoncurrentVersionTransition>    </Rule>    <Rule>        <ID></ID>        <Filter>            <Prefix></Prefix>        </Filter>        <Status></Status>        <Expiration>            <ExpiredObjectDeleteMarker></ExpiredObjectDeleteMarker>        </Expiration>        <NoncurrentVersionExpiration>            <NoncurrentDays></NoncurrentDays>        </NoncurrentVersionExpiration>        <AbortIncompleteMultipartUpload>            <DaysAfterInitiation></DaysAfterInitiation>        </AbortIncompleteMultipartUpload>    </Rule></LifecycleConfiguration>

具体内容描述如下：

响应

响应头

此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

响应体

该响应体为空。

错误码

此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

实际案例

请求

PUT /?lifecycle HTTP/1.1Host:examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Wed, 16 Aug 2017 11:59:33 GMTAuthorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1502855771;1502935771&q-key-time=1502855771;1502935771&q-header-list=content-md5;host&q-url-param-list=lifecycle&q-signature=f3aa2c708cfd8d4d36d658de56973c9cf1c2****Content-MD5: LcNUuow8OSZMrEDnvndw1Q==Content-Length: 348Content-Type: application/x-www-form-urlencoded


                  id1                              documents/                        Enabled                              100                  ARCHIVE                                    id2                              logs/                        Enabled                              10                  STANDARD_IA                  

响应

HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 0Date: Wed, 16 Aug 2017 11:59:33 GMTServer: tencent-cosx-cos-request-id: NTk5NDMzYTRfMjQ4OGY3Xzc3NGRf****



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠