调用PutBucketAccessMonitor接口可以开启或关闭存储空间(Bucket)的访问跟踪状态。开启访问跟踪后,OSS将记录Object的最后一次访问时间。此时您可以配置基于最后一次访问时间(Last Access Time)策略的生命周期规则来自动监测数据的访问模式并识别冷数据,然后将识别出来的冷数据进行存储类型的转换,从而达到数据的冷热分层存储,最终降低存储成本。
注意事项
要配置存储空间的访问跟踪状态,您必须有oss:PutBucketAccessMonitor权限。具体操作,请参见为RAM用户授予自定义的权限策略。
请求语法
PUT /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue 
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
请求元素
| 名称 | 类型 | 是否必选 | 示例值 | 描述 | 
| AccessMonitorConfiguration | 容器 | 是 | 不涉及 | Bucket的访问跟踪状态配置信息。 子节点:Status | 
| Status | 字符串 | 是 | Enabled | 指定是否为Bucket开启访问跟踪。取值范围如下: 
 父节点:AccessMonitorConfiguration | 
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
示例
请求示例
PUT /?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
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>返回示例
HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS相关文档
- 关于如何配置基于最后一次访问时间的生命周期规则,请参见基于最后一次访问时间的生命周期规则。 
- 开启访问跟踪状态后,您可以调用PutBucketLifecycle接口为存储空间(Bucket)设置基于最后一次访问时间的生命周期规则(IsAccessTime设置为true)。更多信息,请参见PutBucketLifecycle。 
SDK
本接口对应的各语言SDK如下:
命令行工具ossutil
PutBucketAccessMonitor接口所对应的ossutil命令,请参见put-bucket-access-monitor。
错误码
| 错误码 | HTTP状态码 | 描述 | 
| MalformedXML | 400 | Bucket的访问跟踪状态配置错误。 | 
| AccessMonitorDisableNotAllowed | 400 | Bucket存在基于atime的生命周期规则,无法修改Bucket的访问跟踪状态为Disabled。 | 
| AccessDenied | 403 | 没有访问该Bucket的权限。 | 
| NoSuchBucket | 404 | 目标Bucket不存在。 |