对象存储

产品文档

对象存储

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-09-01 19:17:05
文档反馈 docs feedback