tencent cloud

Cloud Object Storage

ドキュメントCloud Object Storage

PUT Bucket Access Monitor

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-06-02 10:47:46

Feature Description

The PUT Bucket Access Monitor request enables access tracking for a bucket. After access tracking is enabled, you can configure lifecycle rules based on the last access time. For details, see Lifecycle Rules Based on Access Time.
Note:
This API is an allowlist feature. To use it, please contact us.

Authorization Description

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

Request

Request Example

PUT /?accessmonitor HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Content-Length: length
Date: GMT Date
Authorization: Auth String 
Content-MD5: MD5
Note:
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com. Here, <BucketName-APPID> is the bucket name with the APPID suffix, for example, examplebucket-1250000000. For details, see the Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions documents. <Region> is the available region of COS. For details, see the Regions and Access Domains document.
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 specific node content of the request body for this API is:
<AccessMonitorConfiguration>
    <Status>Enabled</Status>
</AccessMonitorConfiguration>
The specific content is described as follows:
Node Name (Keyword)
Parent Node
Description
Type
Required
AccessMonitorConfiguration
None
Access tracking status configuration
Container
Yes
Status
AccessMonitorConfiguration
Whether to enable access tracking. Supported values: Enabled, Disabled.
Note:
You can modify the access tracking status of a bucket to Disabled only when the bucket has no lifecycle rules based on access time.
Enum
Yes

Response

Response Headers

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

Response Body

This response body is empty.

Error Codes

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

Practical Case

Request

PUT /?accessmonitor HTTP/1.1
Host: examplebucket-appid.cos.region.myqcloud.com
Date: GMT Date
Authorization: SignatureValue 

<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
    <Status>Enabled</Status>
</AccessMonitorConfiguration>

Response

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Date: GMT Date
Server: tencent-cos
x-cos-request-id: NTk5NDMzYTRfMjQ4OGY3Xzc3NGRf****



次の記事へ: Release Notes

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック