对象存储

对象存储

产品文档

对象存储

帮助中心 > OpenAPI & SDK > 对象存储 > Put Bucket lifecycle
搜本产品

Put Bucket Lifecycle

描述

京东云对象存储通过Bucket规则设置，支持对象的生命周期（Lifecycle）管理功能。可自动删除过期的Object，从而使Bucket在使用中便于维护且能降低成本。用户如果手工维护数据的生命周期，则费时费力；但如果不去维护，则会产生不菲的费用。生命周期管理可以帮助用户自动化完成数据生命周期管理，实现数据删除的自动流程，节约人力和金钱成本。

该操作可以为指定Bucket设置生命周期规则以及替换现有规则。 资源过期删除是不可逆的，请根据您的需求合理配置文件生命周期时间计划。

请求

语法


PUT /?lifecycle HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: length
Date: date
Authorization: authorization string
Content-MD5: MD5
 
Lifecycle configuration in the request body

请求参数

无请求参数

请求Header

无特殊请求Header

请求元素

名称 描述 必须
LifecycleConfiguration 全部Lifecycle Rule的Container，最多允许配置1000条Rule。
类型：Container
父标签：无
子标签：Rule		 是
Rule LifecycleConfiguration下的子标签，某一个lifecycle Rule的具体规则；最多1000条Rule。
类型：Container
父标签：LifecycleConfiguration		 是
ID 每条Rule的唯一标识符，最大长度不允许超过64个字符。
类型：String
父标签：Rule		 否
Status 控制Rule的可用状态，若为Disable，则忽略该条Rule；若为Enable，就会按照定义好的Rule去执行。
类型：String
父标签：Rule
有效值：Enabled，Disabled		 是
Filter 定义生命周期管理策略所影响的Object的过滤条件，支持通过Prefix过滤，若定义了<Filter></Filter>，则视为对该Bucket下的全部Object生效。
类型：Container
父标签：Rule
子标签：Prefix,Tag		 是
Prefix 通过指定Object的Prefix来定义哪些Object受生命周期管理策略的影响，若定义了<Prefix></Prefix>，则视为无前缀匹配的过滤条件。在一个Rule的Filter中仅允许一个Prefix存在。采用utf-8编码下不超过1022个字节。
类型：String
父标签：Filter		 否
Tag 通过指定Object的Tag来定义哪些Object受生命周期管理策略的影响。Tag和Prefix可以并存。
类型：Container
父标签：Filter
子标签：Key,Value		 否
Key 标签键。采用utf-8编码下不超过128个字节。
类型：String
父标签：Tag		 若有Tag则必须
Value 标签值。采用utf-8编码下不超过256个字节。
类型：String
父标签：Tag		 否
Days 指定符合过滤条件的Object，在上传到Bucket多少天之后做存储类型转换，若在Expiration标签下有Date存在，则不能再指定Days。
类型：Positive Integer（正整数）
父标签：Expiration、Transition		 若没有指定Date，则必须
Date 指定符合过滤条件的Object，在上传到Bucket之后的某个日期做存储类型转换，若在Expiration标签下有Days存在，则不能再指定Date。日期格式必须符合 ISO 8601格式规范，午夜UTC。
类型：String
父标签：Expiration、Transition		 若没有指定Days，则必须
Expiration 指定何时对Object执行过期删除操作。
类型：Container
子标签：Days、Date
父标签：Rule		 否
AbortIncompleteMultipartUpload 指定何时对未完成的分片上传执行Abort Multipart Upload操作。
类型：Container
子标签：DaysAfterInitiation
父标签：Rule		 否
DaysAfterInitiation 指定OSS执行终止分片上传的时间段（自初始化分片上传后的天数），最大为2147483647
类型：Positive Integer
父标签：AbortIncompleteMultipartUpload		 否
Transition 指定何时对Object执行更改存储类型操作。
类型：Container
子标签：Days、Date、StorageClass
父标签：Rule		 否
StorageClass 指定转换的存储类型
类型：string
有效值：STANDARD_IA、GLACIER		 否

响应

响应Header

无特殊响应Header

响应元素

无响应元素

示例

请求示例


PUT /?lifecycle HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Content-Length: length
Date: date
Authorization: authorization string
Content-MD5: MD5

<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Filter>
       <Prefix>documents/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Filter>
       <Prefix>documents/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

响应示例


HTTP/1.1 200 OK
x-amz-request-id: 9E26D08072A8EF9E
Date: Wed, 14 May 2014 02:11:22 GMT
Content-Length: 0
Server: JDCloudOSS
更新时间：2021-12-01 16:54:25
feedback