Queries the access tracking status of a bucket. You must first enable access tracking for a bucket if you want to configure a lifecycle rule based on last access time to, for example, monitor access patterns and move cold data to a more cost-effective storage class.
Usage notes
To query the access tracking status of a bucket, you must have the oss:GetBucketAccessMonitor
permission. For more information, see Attach a custom policy to a RAM user.
Request syntax
GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
Request headers
This request contains only common request headers. For more information, see Common HTTP headers.
Response headers
This request contains only common response headers. For more information, see Common HTTP headers.
Response elements
Element | Type | Example | Description |
AccessMonitorConfiguration | Container | N/A | The access tracking configurations of the bucket. Child nodes: Status |
Status | String | Enabled | The access tracking status of the bucket. Valid values:
Parent nodes: AccessMonitorConfiguration |
Examples
Sample request
GET /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************
Sample response
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.
Error codes
Error code | HTTP status code | Description |
AccessDenied | 403 | You are not authorized to access the bucket. |
NoSuchBucket | 404 | The bucket does not exist. |