调用PutBucketAccessMonitor接口配置存储空间(Bucket)的访问跟踪状态。

注意事项

要配置存储空间的访问跟踪状态,您必须有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开启访问跟踪。取值范围如下:
  • Enabled:开启

    Bucket开启访问跟踪后,OSS以访问跟踪开启时间作为Bucket中所有Object的默认last access time(最后一次访问时间),并基于用户的访问行为更新Object的last access time。

    Object的last access time更新为异步操作,存在一定延迟。如果您在24小时内多次访问同一Object,则last access time只会更新为最早一次的访问时间。您可以为Bucket设置基于last access time匹配规则的生命周期规则。

  • Disabled(默认):未开启

    只有当Bucket不存在基于last access time匹配规则的生命周期规则时,才能修改Bucket的访问跟踪状态为Disabled。

父节点:AccessMonitorConfiguration

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

示例

请求示例
PUT /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3**** 
<?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

错误码

错误码 HTTP状态码 描述
MalformedXML 400 Bucket的访问跟踪状态配置错误。
AccessMonitorDisableNotAllowed 400 Bucket存在基于atime的生命周期规则,无法修改Bucket的访问跟踪状态为Disabled。
AccessDenied 403 没有访问该Bucket的权限。
NoSuchBucket 404 目标Bucket不存在。