全部产品
Search
文档中心

对象存储 OSS:GetBucketAccessMonitor

更新时间:Apr 29, 2024

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

注意事项

要获取存储空间的访问跟踪状态,您必须有oss:GetBucketAccessMonitor权限。具体操作,请参见为RAM用户授权自定义的权限策略

请求语法

GET /?accessmonitor HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

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

响应头

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

响应元素

名称

类型

示例值

描述

AccessMonitorConfiguration

容器

不涉及

Bucket的访问跟踪状态配置信息。

子节点:Status

Status

字符串

Enabled

Bucket的访问跟踪状态。取值范围如下:

  • Enabled:已开启

  • Disabled:未开启

父节点:AccessMonitorConfiguration

示例

请求示例

GET /?accessmonitor HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Date: Mon, 26 Jul 2021 13:08:38 GMT
Authorization: OSS qn6q**************:77Dv****************

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Length: 125
Content-Type: application/xml
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<AccessMonitorConfiguration>
  <Status>Enabled</Status>
</AccessMonitorConfiguration>

相关文档

  • 关于如何配置基于最后一次访问时间的生命周期规则,请参见基于最后一次访问时间的生命周期规则

  • 调用PutBucketLifecycle接口为存储空间(Bucket)设置基于最后一次访问时间的生命周期规则(IsAccessTime设置为true)时,需确保访问跟踪状态已开启。更多信息,请参见PutBucketLifecycle

错误码

错误码

HTTP状态码

描述

AccessDenied

403

没有访问该Bucket的权限。

NoSuchBucket

404

目标Bucket不存在。