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-阿裏雲