全部產品
Search

搜尋本產品

    ：PutBucketAccessMonitor

    文件中心

    ：PutBucketAccessMonitor

    更新時間：Jun 19, 2024

    調用PutBucketAccessMonitor介面可以開啟或關閉儲存空間（Bucket）的訪問跟蹤狀態。開啟訪問跟蹤後，OSS將記錄Object的最後一次訪問時間。此時您可以配置基於最後一次訪問時間（Last Access Time）策略的生命週期規則來自動監測資料的訪問模式並識別冷資料，然後將識別出來的冷資料進行儲存類型的轉換，從而達到資料的冷熱階層式存放區，最終降低儲存成本。

    注意事項

    要配置儲存空間的訪問跟蹤狀態，您必須有oss:PutBucketAccessMonitor許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

    請求文法

    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的訪問跟蹤狀態配置資訊。

    子節點：Status

    Status

    字串

    是

    Enabled

    指定是否為Bucket開啟訪問跟蹤。取值範圍如下：

    • Enabled：開啟

      Bucket開啟訪問跟蹤後，OSS以訪問跟蹤開啟時間作為Bucket中所有Object的預設Last Access Time（最後一次訪問時間），並基於使用者的訪問行為更新Object的Last Access Time。

      Object的Last Access Time更新為非同步作業，存在一定延遲。如果您在24小時內多次訪問同一Object，則Last Access Time只會更新為最早一次的訪問時間。您可以為Bucket設定基於Last Access Time匹配規則的生命週期規則。

    • Disabled（預設）：未開啟

      只有當Bucket不存在基於Last Access Time匹配規則的生命週期規則時，才能修改Bucket的訪問跟蹤狀態為Disabled。

    父節點：AccessMonitorConfiguration

    回應標頭

    此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（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

    相關文檔

    • 關於如何配置基於最後一次訪問時間的生命週期規則，請參見基於最後一次訪問時間的生命週期規則。

    • 開啟訪問跟蹤狀態後，您可以調用PutBucketLifecycle介面為儲存空間（Bucket）設定基於最後一次訪問時間的生命週期規則（IsAccessTime設定為true）。更多資訊，請參見PutBucketLifecycle。

    錯誤碼

    錯誤碼

    HTTP狀態代碼

    描述

    MalformedXML

    400

    Bucket的訪問跟蹤狀態配置錯誤。

    AccessMonitorDisableNotAllowed

    400

    Bucket存在基於atime的生命週期規則，無法修改Bucket的訪問跟蹤狀態為Disabled。

    AccessDenied

    403

    沒有訪問該Bucket的許可權。

    NoSuchBucket

    404

    目標Bucket不存在。