調用GetBucketAccessMonitor介面擷取指定儲存空間Bucket的訪問跟蹤狀態 - Object Storage Service

如果您希望配置基於最後一次訪問時間（Last Access Time）策略的生命週期規則來自動監測Bucket中Object的訪問模式並識別冷資料，然後將識別出來的冷資料進行儲存類型轉換，最終降低儲存成本，您需要確保訪問跟蹤已開啟。調用GetBucketAccessMonitor介面可以擷取指定儲存空間（Bucket）的訪問跟蹤狀態。

注意事項

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

請求文法

GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱

類型

樣本值

描述

AccessMonitorConfiguration

容器

不涉及

Bucket的訪問跟蹤狀態配置資訊。

子節點：Status

Status

字串

Enabled

Bucket的訪問跟蹤狀態。取值範圍如下：

Enabled：已開啟
Disabled：未開啟

父節點：AccessMonitorConfiguration

樣本

請求樣本

GET /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Thu, 17 Apr 2025 13:08:38 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回樣本

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 125
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>

SDK

本介面對應的各語言SDK如下：

命令列工具ossutil

GetBucketAccessMonitor介面所對應的ossutil命令，請參見get-bucket-access-monitor。

錯誤碼

錯誤碼	HTTP狀態代碼	描述
AccessDenied	403	沒有訪問該Bucket的許可權。
NoSuchBucket	404	目標Bucket不存在。

Object Storage Service：調用GetBucketAccessMonitor介面擷取指定儲存空間Bucket的訪問跟蹤狀態