赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 对象存储
  4. 开发参考
  5. API参考
  6. 关于Bucket操作
  7. 访问跟踪(AccessMonitor)
  8. PutBucketAccessMonitor

PutBucketAccessMonitor

  • 访问跟踪(AccessMonitor)
  • 发布于 2025-04-21
  • 0 次阅读
文档编辑
文档编辑

调用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开启访问跟踪。取值范围如下:

  • 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 qn6q**************:77Dv**************** 
<?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如下:

  • Java

  • Python

  • Go V2

命令行工具ossutil

PutBucketAccessMonitor接口所对应的ossutil命令,请参见put-bucket-access-monitor。

错误码

错误码

HTTP状态码

描述

MalformedXML

400

Bucket的访问跟踪状态配置错误。

AccessMonitorDisableNotAllowed

400

Bucket存在基于atime的生命周期规则,无法修改Bucket的访问跟踪状态为Disabled。

AccessDenied

403

没有访问该Bucket的权限。

NoSuchBucket

404

目标Bucket不存在。

相关文章

PutBucketAccessMonitor 2025-04-21 18:15

调用PutBucketAccessMonitor接口可以开启或关闭存储空间(Bucket)的访问跟踪状态。开启访问跟踪后,OSS将记录Object的最后一次访问时间。此时您可以配置基于最后一次访问时间(Last Access Time)策略的生命周期规则来自动监测数据的访问模式并识别冷数据,然后将识

GetBucketAccessMonitor 2025-04-21 18:15

如果您希望配置基于最后一次访问时间(Last Access Time)策略的生命周期规则来自动监测Bucket中Object的访问模式并识别冷数据,然后将识别出来的冷数据进行存储类型转换,最终降低存储成本,您需要确保访问跟踪已开启。调用GetBucketAccessMonitor接口可以获取指定存储

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号