114
阿里云
PutBucketLifecycle__关于Bucket的操作_API 参考_对象存储 OSS-阿里云
Bucket的拥有者可以通过Put Bucket Lifecycle来设置Bucket的Lifecycle配置。Lifecycle开启后,OSS将按照配置,定期自动删除与Lifecycle规则相匹配的Object。
请求语法
PUT /?lifecycle HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Authorization: SignatureValue
Host: BucketName.oss.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
<Rule>
<ID>RuleID</ID>
<Prefix>Prefix</Prefix>
<Status>Status</Status>
<Expiration>
<Days>Days</Days>
</Expiration>
<AbortMultipartUpload>
<Days>Days</Days>
</AbortMultipartUpload>
</Rule>
</LifecycleConfiguration>
请求元素(Request Elements)
名称 | 描述 | 是否必需 |
---|---|---|
CreatedBeforeDate | 指定规则何时之前生效。日期必需服从ISO8601的格式,并且总是UTC的零点。 例如:2002-10-11T00:00:00.000Z 类型:字符串 父节点:Expiration或者AbortMultipartUpload |
Days和CreatedBeforeDate二选一 |
Days | 指定规则在对象最后修改时间过后多少天生效。 类型:正整数 父节点:Expiration |
Days和CreatedBeforeDate二选一 |
Expiration | 指定Object规则的过期属性。 类型:容器 子节点:Days或CreatedBeforeDate 父节点:Rule |
否 |
AbortMultipartUpload | 指定未完成的Part规则的过期属性。 类型:容器 子节点:Days或CreatedBeforeDate 父节点:Rule |
否 |
ID | 规则唯一的ID。最多由255字节组成。当用户没有指定,或者该值为空时,OSS会为用户生成一个唯一值。 类型:字符串 子节点:无 父节点:Rule |
否 |
LifecycleConfiguration | Lifecycle配置的容器,最多可容纳1000条规则。 类型:容器 子节点:Rule 父节点:无 |
是 |
Prefix | 指定规则所适用的前缀。只有匹配前缀的对象才可能被该规则所影响。不可重叠。 类型:字符串 子节点:无 父节点:Rule |
是 |
Rule | 表述一条规则 类型:容器 子节点:ID,Prefix,Status,Expiration 父节点:LifecycleConfiguration |
是 |
Status | 如果其值为Enabled,那么OSS会定期执行该规则;如果是Disabled,那么OSS会忽略该规则。 类型:字符串 父节点:Rule 有效值:Enabled,Disabled |
是 |
细节分析
- 只有Bucket的拥有者才能发起Put Bucket Lifecycle请求,否则返回403 Forbidden消息。错误码:AccessDenied。
- 如果此前没有设置过Lifecycle,此操作会创建一个新的Lifecycle配置;否则,就覆写先前的配置。
- 可以对Object设置过期时间,也可以对Part设置过期时间。这里的Part指的是以分片上传方式上传,但最后未提交的分片。
示例
请求示例:
PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 443
Date: Mon, 14 Apr 2014 01:08:38 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:KU5h8YMUC78M30dXqf3JxrTZHiA=
<?xml version="1.0" encoding="UTF-8"?>
</LifecycleConfiguration>
<Rule>
<ID>delete objects and parts after one day</ID>
<Prefix>logs/</Prefix>
<Status>Enabled</Status>
<Expiration>
<Days>1</Days>
</Expiration>
<AbortMultipartUpload>
<Days>1</Days>
</AbortMultipartUpload>
</Rule>
<Rule>
<ID>delete created before date</ID>
<Prefix>backup/</Prefix>
<Status>Enabled</Status>
<Expiration>
<CreatedBeforeDate>2014-10-11T00:00:00.000Z</CreatedBeforeDate>
</Expiration>
<AbortMultipartUpload>
<CreatedBeforeDate>2014-10-11T00:00:00.000Z</CreatedBeforeDate>
</AbortMultipartUpload>
</Rule>
</LifecycleConfiguration>
返回示例:
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
Date: Mon, 14 Apr 2014 01:17:10 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
最后更新:2016-11-23 17:16:07
上一篇:
PutBucketReferer__关于Bucket的操作_API 参考_对象存储 OSS-阿里云
下一篇:
GetBucket__关于Bucket的操作_API 参考_对象存储 OSS-阿里云
ECS Driver 简介__开发者工具_容器服务-阿里云
企业邮箱 Windows Live Mail 的 POP3/IMAP 协议设置方法__客户端使用_邮箱常见问题_企业邮箱-阿里云
重置实例密码__实例_用户指南_云服务器 ECS-阿里云
数据管理服务协议__产品常见问题_数据管理-阿里云
制作报表-门户__制作报表_Quick BI-阿里云
执行时间设置__测试配置_Lite用户使用手册_性能测试-阿里云
锐化__图片效果_图片处理指南_对象存储 OSS-阿里云
域名交易手续费常见问题___域名交易_域名-阿里云
DescribeRegions__LoadBalancer相关API_API 参考_负载均衡-阿里云
更新媒体-添加标签__媒体接口_API使用手册_视频点播-阿里云
相关内容
常见错误说明__附录_大数据计算服务-阿里云
发送短信接口__API使用手册_短信服务-阿里云
接口文档__Android_安全组件教程_移动安全-阿里云
运营商错误码(联通)__常见问题_短信服务-阿里云
设置短信模板__使用手册_短信服务-阿里云
OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
消息通知__操作指南_批量计算-阿里云
设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云