最近更新时间: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 | 指定是否为Bucket开启访问跟踪。取值范围如下: * Enabled:开启。Bucket开启访问跟踪后,访问跟踪开启时间作为Bucket中所有Object的默认最后一次访问时间。 * Disabled:未开启。只有当Bucket不存在基于最后一次访问时间匹配规则的生命周期规则时,才能修改Bucket的访问跟踪状态为Disabled。
| 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不存在。 |
纯净模式