PutBucketAccessMonitor
調(diào)用PutBucketAccessMonitor接口可以開啟或關(guān)閉存儲空間(Bucket)的訪問跟蹤狀態(tài)。開啟訪問跟蹤后,OSS將記錄Object的最后一次訪問時間。此時您可以配置基于最后一次訪問時間(Last Access Time)策略的生命周期規(guī)則來自動監(jiān)測數(shù)據(jù)的訪問模式并識別冷數(shù)據(jù),然后將識別出來的冷數(shù)據(jù)進行存儲類型的轉(zhuǎn)換,從而達到數(shù)據(jù)的冷熱分層存儲,最終降低存儲成本。
注意事項
要配置存儲空間的訪問跟蹤狀態(tài),您必須有oss:PutBucketAccessMonitor
權(quán)限。具體操作,請參見為RAM用戶授權(quán)自定義的權(quán)限策略。
請求語法
PUT /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
AccessMonitorConfiguration | 容器 | 是 | 不涉及 | Bucket的訪問跟蹤狀態(tài)配置信息。 子節(jié)點:Status |
Status | 字符串 | 是 | Enabled | 指定是否為Bucket開啟訪問跟蹤。取值范圍如下:
父節(jié)點:AccessMonitorConfiguration |
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請參見公共響應(yīng)頭(Common Response Headers)。
示例
請求示例
PUT /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>
返回示例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
相關(guān)文檔
關(guān)于如何配置基于最后一次訪問時間的生命周期規(guī)則,請參見基于最后一次訪問時間的生命周期規(guī)則。
開啟訪問跟蹤狀態(tài)后,您可以調(diào)用PutBucketLifecycle接口為存儲空間(Bucket)設(shè)置基于最后一次訪問時間的生命周期規(guī)則(IsAccessTime設(shè)置為true)。更多信息,請參見PutBucketLifecycle。
錯誤碼
錯誤碼 | HTTP狀態(tài)碼 | 描述 |
MalformedXML | 400 | Bucket的訪問跟蹤狀態(tài)配置錯誤。 |
AccessMonitorDisableNotAllowed | 400 | Bucket存在基于atime的生命周期規(guī)則,無法修改Bucket的訪問跟蹤狀態(tài)為Disabled。 |
AccessDenied | 403 | 沒有訪問該Bucket的權(quán)限。 |
NoSuchBucket | 404 | 目標Bucket不存在。 |