全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

PUT Bucket AccessMonitor

最近更新时间:2025-04-02 11:03:09

描述

该接口可以开启或关闭存储空间(Bucket)的访问跟踪状态,作为生命周期设置最后一次访问时间的前置条件。开启访问跟踪后,桶内Object的最后一次访问时间将被记录。

请求

请求语法

PUT /?accessmonitor HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5}

accessmonitor configuration in the request body	

请求头部

此接口仅涉及公共请求头。

请求参数

参数

描述

默认值

是否必选

AccessMonitorConfiguration

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

  • 子节点:Status

Status

指定是否为Bucket开启访问跟踪。取值范围如下:

* Enabled:开启。Bucket开启访问跟踪后,访问跟踪开启时间作为Bucket中所有Object的默认最后一次访问时间。

* Disabled:未开启。只有当Bucket不存在基于最后一次访问时间匹配规则的生命周期规则时,才能修改Bucket的访问跟踪状态为Disabled。

  • 父节点:AccessMonitorConfiguration

Disabled

响应

响应头部

该接口只返回常用响应头部

响应内容

该接口不返回响应内容。

特殊错误

该接口不返回任何特殊错误。

示例

请求示例

PUT /?accessmonitor HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
Content-length: {length}
Content-MD5: {md5}

<AccessMonitorConfiguration>
    <Status>Enabled</Status>
</AccessMonitorConfiguration>

响应示例

HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2017 09:14:23 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add54218***

错误码

HTTP状态码

错误码

描述

400

BadRequest

Bucket没有开启访问追踪时,设置了基于最后一次访问时间的(IsAccessTime=ture生命周期规则。

400

AccessMonitorDisableNotAllowed

Bucket存在基于最后一次访问时间的(IsAccessTime=true生命周期规则,无法修改Bucket的访问跟踪状态为Disabled。

403

AccessDenied

没有访问该Bucket的权限。

404

NoSuchBucket

目标Bucket不存在。

纯净模式常规模式

纯净模式

点击可全屏预览文档内容