Query the access tracking status of a bucket by calling GetBucketAccessMonitor

Note

To query the access tracking status of a bucket, you must have the oss:GetBucketAccessMonitor permission. For more information, see Grant a custom policy.

Request syntax

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

Request headers

DescribeRegions uses only common request headers. For more information, see Common request headers.

Response headers

The response contains only common response headers. For more information, see Common response headers.

Response elements

Example

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>

References

• For more information about lifecycle rules based on last access time, see Lifecycle rules based on last access time.

• After access tracking is enabled, you can call the PutBucketLifecycle operation to configure a lifecycle rule based on last access time. For more information, see PutBucketLifecycle.

OSS SDKs

You can use OSS SDKs for the following programming languages to call GetBucketAccessMonitor:

• Java

• Python V2

• Go V2

• PHP V2

ossutil

For information about the ossutil command that corresponds to the GetBucketAccessMonitor operation, see get-bucket-access-monitor.

Error codes