全部文档
当前文档

暂无内容

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

文档中心

PUT Bucket ArchiveDirectRead

最近更新时间:2026-07-20 14:02:58

该接口用于为桶开启或关闭归档直读功能,使⽤此接⼝的⽤⼾必须是该 Bucket 的所有者或具有ks3:PutBucketArchiveDirectRead权限。

1. 开启或关闭归档直读功能,预计5分钟内规则生效。

2. 有关归档直读的更多详情,请参见文档:归档直读

请求

请求语法

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

ArchiveDirectReadConfiguration in the request body

请求参数

该接口不使用请求参数。

请求头

该接口仅使用公共请求头

请求体

请求体为一段描述桶开启或关闭归档直读规则的XML:

<ArchiveDirectReadConfiguration>
    <Enabled>true</Enabled>
</ArchiveDirectReadConfiguration>

XML中的节点描述如下:

名称

描述

是否必选

ArchiveDirectReadConfiguration

包含归档直读配置的容器。

  • 类型:容器

Enabled

是否为Bucket开启归档直读。

  • 类型:布尔型

  • 取值:

    • true:开启归档直读

    • false:关闭归档直读

  • 父节点:ArchiveDirectReadConfiguration

响应

响应头

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

响应体

该接口不返回响应体。

示例

请求示例

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

<ArchiveDirectReadConfiguration>
    <Enabled>true</Enabled>
</ArchiveDirectReadConfiguration>

响应示例

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 状态码

Code

Message

描述

400 Bad Request

InvalidRequest

The request you sent is invalid.

请求不合法

403 Forbidden

AccessDenied

AccessDenied.

缺少权限

404 Not Found

NoSuchBucket

The specified bucket does not exist.

桶不存在

400 Bad Request

InvalidArgument

XXX is invalid.

参数为空、参数无效、参数值填写的不合法

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈