喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>
点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>
天翼云对象存储（经典版）I型API参考-PUT Bucket Lifecycle
此操作用来设置Bucket生命周期规则。只有根用户和具有PUT Bucket Lifecycle权限的子用户才能执行此操作。
生命周期是指对象从更新开始到被删除/转换存储类型的时间。
通过设置存储桶的生命周期规则，可以：
l 删除与生命周期规则匹配的对象。当对象的生命周期到期时，OOS会异步删除它们。生命周期中配置的到期时间和实际删除时间之间可能会有一段延迟。但对象到期被删除后，用户将不需要为到期的对象付费。OOS删除到期对象后，会在Bucket log中记录一条日志，操作项是"OOS.EXPIRE.OBJECT"。
l 将与生命周期规则匹配的对象由标准存储转换为低频访问存储。OOS转换存储类型为低频访问存储后，会在access logs中记录一条日志，操作项是"OOS.TRANSITION_SIA.OBJECT"。
注意：
l 如果对象的生命周期规则设置的是到期后删除，对象到期后将被永久删除，无法恢复。
l 如果Bucket内的生命周期规则正在执行时被修改配置，则修改后的配置并不立即生效，需等原生命周期规则执行完成后才能生效。
l 如果Bucket没有配置过生命周期规则，执行该操作将创建新的生命周期规则；如果Bucket已存在生命周期规则，则执行此操作将覆盖原有规则。
l 每个Bucket最多创建1000条生命周期规则。
l 同一Bucket，同一类型（到期删除或者到期转成低频访问存储）的生命周期规则不能存在叠加前缀，例如已创建到期删除对象的生命周期规则的前缀是ABC，则无法再创建前缀为ABCD或AB或A的到期删除对象的生命周期规则。
l 当用户为Bucket设置了生命周期规则，这些规则将同时应用于已有对象和后续新创建的对象。例如，用户今天增加了一个生命周期，指定某些前缀的对象30天后过期，那么OOS将会将满足条件的30天前创建的对象都加入到待删除队列中。
OOS通过将对象的创建时间加上生命周期时间来计算到期时间，并且将时间近似到下一天的GMT零点时间。例如，一个对象于GMT 2016年1月15日10:30创建，生命周期为3天，那么对象的到期时间是GMT 2016年1月19日00:00。当重写一个对象时，OOS将以最后更新时间为准，来重新计算该对象的到期时间。
可以通过GET Object、HEAD Object查询对象的到期时间。
请求语法
PUT /?lifecycle HTTP/1.1 Host: BucketName.oos-cn.ctyunapi.cn Date: date Authorization: signatureValue Content-MD5: MD5
<LifecycleConfiguration> <Rule> <ID>UniqueIdentifier</ID> <Prefix>Prefix</Prefix> <Status>LifecycleStatus</Status> <Expiration> <Days>NumberOfDays</Days> </Expiration> </Rule> </LifecycleConfiguration> |
请求头
名称 | 描述 | 是否必须 |
Content-MD5 | 数据的base64编码的128位MD5。此请求头必填，以便校验数据的完整性。 | 是 |
请求参数
名称 | 描述 | 是否必须 |
LifecycleConfiguration | 生命周期规则容器，最多包含1000个规则。 类型：容器 子节点：Rule | 是 |
Rule | 配置一条生命周期规则的容器。 类型：容器 子节点：ID、Prefix、Status、Expiration、Transition 父节点：LifecycleConfiguration | 是 |
ID | 规则的唯一标识。 类型：字符串 父节点：Rule 取值：1~255个字符。说明：如果ID不填写，系统会随机生成一个48字节长度的ID。 | 否 |
Prefix | 指定使用生命周期规则的对象前缀。只有匹配对象前缀的对象才能被该规则影响，且对于同一Bucket，同一类型的生命周期规则的前缀不可重叠。如果prefix为空，则默认生命周期规则匹配整个存储桶。 类型：字符串 父节点：Rule 取值：0~1024个字符 | 是 |
Status | 指定生命周期规则的状态。 类型：字符串 父节点：Rule 取值：
| 是 |
Expiration | 指定生命周期规则的过期时间容器。 类型：容器 父节点：Rule 子节点：Days或Date | Expiration和Transition至少包含1个 |
Transition | 指定生命周期规则的转换存储类型。 类型：容器 父节点：Rule 子节点：Days或Date、StorageClass | Expiration和Transition至少包含一个 |
Days | 指定生命周期规则在匹配对象创建多少天后生效。 注意：如果过期时间和转换时间同时配置，过期时间需要晚于转换时间。 类型：整型 父节点：Expiration或Transition 取值：大于0的正整数 | Days和Date二选一 |
Date | 推荐：TOP云智能建站优惠活动，仅880元即可搭建一个后台管理五端合一的智能网站（PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序），独享百度搜索SEO优势资源，让你的网站不仅有颜值有排面，更有排名，可以实实在在为您带来效益，请点击进入TOP云智能建站>>>，或咨询在线客服了解详情。
相关阅读
猜您喜欢
Copyright ? 2021-2025 尊托云数科技 All Rights Reserved. |
湘公网安备43019002001857号
备案号：
客服1 