tencent cloud

Cloud Object Storage

DocumentationCloud Object Storage

GET Bucket Access Monitor

Download
Focus Mode
Font Size
Last updated: 2026-06-02 10:37:02

Feature Description

The GET Bucket Access Monitor request is used to view the access tracking status of a bucket.

Authorization Description

In the authorization policy, set the action to cos:GetBucketAccessMonitor. View all actions.

Request

Request Example

GET /?accessmonitor HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT Date
Authorization: Auth String
Note:
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com: <BucketName-APPID> indicates the bucket name suffixed with APPID, for example, examplebucket-1250000000. For details, refer to the Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions documentation. <Region> indicates the available region for COS. For details, refer to the Regions and Access Endpoints documentation.
Authorization: Auth String (For details, see Request Signature).

Request Header

This API only uses common request headers. For details, see Common Request Headers.

Request Body

The request body of this request is empty.

Response

Response Headers

This API only returns common response headers. For details, see Common Response Headers.

Response Body

The content and meaning of each element in the response body are consistent with those in the request body of the PUT Bucket Access Monitor API. For details, see the request body node description in the PUT Bucket Access Monitor document.

Error Codes

This API follows unified error responses and error codes. For details, see Error Codes.

Practical Case

Request

GET /?accessmonitor HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Wed, 26 Jun 2024 07:43:46 GMT
Authorization:q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1502857357;1502937357&q-key-time=1502857357;1502937357&q-header-list=host&q-url-param-list=lifecycle&q-signature=****************************************

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Date: Wed, 26 Jun 2024 07:43:46 GMT
Server: tencent-cos
x-cos-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****

<AccessMonitorConfiguration>
    <Status>Enabled</Status>
</AccessMonitorConfiguration>

Next Topic: Release Notes

Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback