全部文档
当前文档
最近更新时间：2025-06-03 15:21:24
此操作可为已存在的本地冗余存储桶开启或关闭同城冗余功能。开启后新写入的标准/低频存储类型文件将采用同城冗余（多AZ）的形式进行存储，存量文件仍保持本地冗余。该接口使用者必须为桶拥有者或具有ks3:PutBucketDataRedundancySwitch权限。
1. 本地冗余和同城冗余类型的桶均支持开启和关闭同城冗余。
2. 开启同城冗余后，桶内新增的标准和低频存储类型文件将会写入同城冗余集群；关闭同城冗余后，桶内新增的文件将会转为本地冗余集群。存量数据不受影响。
3. 同城冗余开启或关闭生效时间：预计5min。
4. 同城冗余类型计费详情请查看文档：价格详情。
PUT /?dataRedundancySwitch HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
x-kss-data-redundancy-type: ZRS名称 | 类型 | 是否必选 | 描述 |
x-kss-data-redundancy-type | string | 是 | 有效值：
|
该接口只使用常用请求头部。获取更多信息，请点击公共请求头。
该接口不使用请求内容。
该接口除了返回公共响应头外，还返回以下响应头：
名称 | 描述 |
|---|---|
x-kss-data-redundancy-type | 有效值：
|
该接口不返回响应内容。
PUT /?dataRedundancySwitch HTTP/1.1
Host: example.ks3-cn-beijing.ksyuncs.com
Date: Fri, 17 Nov 2024 08:40:17 GMT
Authorization: qn6q**************:77Dv****************
x-kss-data-redundancy-type：ZRSHTTP/1.1 200 OK
x-ks3-request-id: 655726F18EAD9B710C00B235
Date: Fri, 17 Nov 2023 08:40:17 GMT
x-kss-data-redundancy-type：ZRS
Content-Type: application/xml
Content-Length: 151
Server: KS3错误码 | HTTP状态码 | 描述 |
|---|---|---|
AccessDenied | 403 Forbidden | 没有对应的权限或者签名不匹配 |
NoSuchBucket | 404 NotFound | 桶不存在 |
BucketDataRedundancyTypeNotSupport | 400 BadRequest | 存储空间重复开启或重复关闭 |
纯净模式