腾讯云对象存储PutBucketlifecycle

PutBucketLifecycle描述

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

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

请求语法PUT/?lifecycleHTTP/1.1Host:BUCKET_NAME.s3.REGION.jdcloud-oss.comContent-Length:lengthDate:dateAuthorization:authorizationstringContent-MD5:MD5Lifecycleconfigurationintherequestbody请求参数

无请求参数

请求Header

无特殊请求Header

请求元素名称描述必须LifecycleConfiguration全部LifecycleRule的Container,最多允许配置1000条Rule。
类型:Container
父标签:无
子标签:Rule是RuleLifecycleConfiguration下的子标签,某一个lifecycleRule的具体规则;最多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是Prefix通过指定Object的Prefix来定义哪些Object受生命周期管理策略的影响,若定义了Prefix/Prefix,则视为无前缀匹配的过滤条件。在一个Rule的Filter中仅允许一个Prefix存在。采用utf-8编码下不超过1022个字节。
类型:String
父标签:Filter否Days指定符合过滤条件的Object,在上传到Bucket多少天之后做存储类型转换,若在Expiration标签下有Date存在,则不能再指定Days。
类型:PositiveInteger(正整数)
父标签:Expiration若没有指定Date,则必须Date指定符合过滤条件的Object,在上传到Bucket之后的某个日期做存储类型转换,若在Expiration标签下有Days存在,则不能再指定Date。日期格式必须符合ISO8601格式规范,午夜UTC。
类型:String
父标签:Expiration若没有指定Days,则必须Expiration指定何时对Object执行过期删除操作。
类型:Container
子标签:Days、Date
父标签:Rule否AbortIncompleteMultipartUpload指定何时对未完成的分片上传执行AbortMultipartUpload操作。
类型:Container
子标签:DaysAfterInitiation
父标签:Rule否DaysAfterInitiation指定腾讯云对象存储执行终止分片上传的时间段(自初始化分片上传后的天数),最大为2147483647
类型:PositiveInteger
父标签:AbortIncompleteMultipartUpload否响应响应Header

无特殊响应Header

响应元素

无响应元素

示例请求示例PUT/?lifecycleHTTP/1.1Host:BUCKET_NAME.s3.REGION.jdcloud-oss.comContent-Length:lengthDate:dateAuthorization:authorizationstringContent-MD5:MD5LifecycleConfigurationRuleIDid1/IDFilterPrefixdocuments//Prefix/FilterStatusEnabled/StatusExpirationDays365/Days/Expiration/Rule/LifecycleConfiguration响应示例HTTP/1.1200OKx-amz-request-id:9E26D08072A8EF9EDate:Wed,14May201402:11:22GMTContent-Length:0Server:JDCloud腾讯云对象存储