文档中心>对象存储

PUT Bucket Access Monitor

最近更新时间:2024-06-26 17:27:31

我的收藏

功能描述

PUT Bucket Access Monitor 请求用于为存储桶开启访问跟踪。开启访问跟踪后,支持配置基于最后访问时间的生命周期规则,详见 基于访问时间的生命周期规则

授权说明

授权策略中 action 设置为 cos:PutBucketAccessMonitor。查看所有 action

请求

请求示例

PUT /?accessmonitor HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Content-Length: length
Date: GMT Date
Authorization: Auth String
Content-MD5: MD5
说明:
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com,其中 <BucketName-APPID> 为带 APPID 后缀的存储桶名字,例如 examplebucket-1250000000,可参阅 存储桶概览 > 基本信息存储桶概述 > 存储桶命名规范 文档;<Region> 为 COS 的可用地域,可参阅 地域和访问域名 文档。
Authorization: Auth String(详情请参见 请求签名 文档)。

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该 API 接口请求的请求体具体节点内容为:
<AccessMonitorConfiguration>
<Status>Enabled</Status>
</AccessMonitorConfiguration>
具体内容的描述如下:
节点名称(关键字)
父节点
描述
类型
是否必选
AccessMonitorConfiguration
访问跟踪状态配置
Container
Status
AccessMonitorConfiguration
是否开启访问跟踪,支持 Enabled 或 Disabled。
注意:
只有当存储桶不存在基于访问时间的生命周期规则的生命周期规则时,才能修改存储桶的访问跟踪状态为 Disabled。
Enum

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

该响应体为空。

错误码

此接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。

实际案例

请求

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>

响应

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