CreateBucketDataRedundancyTransition

注意事项

• Bucket所属地域支持转换存储冗余类型。支持转换存储冗余类型的地域：华东1（杭州）、华东2（上海）、华北2（北京）、华北 3（张家口）、华北6（乌兰察布）、华南1（深圳）、中国香港、日本（东京）、新加坡、印度尼西亚（雅加达）、德国（法兰克福）

• Bucket的存储冗余类型必须为本地冗余存储。OSS仅支持将本地冗余存储转换为同城冗余存储。

• Bucket的存储类型必须为标准存储、低频访问存储或归档存储，但Bucket中的文件的存储类型可以为冷归档存储和深度冷归档存储。冷归档存储和深度冷归档存储的文件转换后依然为本地冗余存储。冷归档存储和深度冷归档存储的Bucket不支持转换存储冗余类型。

• 要创建存储冗余转换任务，您必须具有oss:CreateBucketDataRedundancyTransition权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• 每个地域都有对应的访问域名（Endpoint）。关于地域与访问域名对应关系的更多信息，请参见访问域名和数据中心。

请求语法

POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求参数

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

示例

• 请求示例

  POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
  Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  Date: Fri, 17 Nov 2023 08:40:17 GMT
  Authorization: OSS qn6q**************:77Dv****************

• 返回示例

  HTTP/1.1 200
  x-oss-request-id: 655726F18EAD9B710C00B235
  Date: Fri, 17 Nov 2023 08:40:17 GMT
  Content-Type: application/xml
  Content-Length: 151
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <BucketDataRedundancyTransition>
    <TaskId>4be5beb0f74f490186311b268bf6****</TaskId>
  </BucketDataRedundancyTransition>

命令行工具ossutil

CreateBucketDataRedundancyTransition接口所对应的ossutil命令，请参见create-bucket-data-redundancy-transition。

错误码