CreateBucketDataRedundancyTransition

调用CreateBucketDataRedundancyTransition接口为Bucket创建存储冗余转换任务。

注意事项

  • 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)

请求参数

名称

类型

是否必选

示例值

描述

x-oss-target-redundancy-type

字符串

ZRS

目标存储冗余类型。OSS仅支持将LRS(本地冗余存储)转换为ZRS(同城冗余存储)。

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

名称

类型

示例值

描述

BucketDataRedundancyTransition

容器

不涉及

存储冗余转换任务的容器。

父节点:无

子节点:TaskId

TaskId

字符串

4be5beb0f74f490186311b268bf6****

存储冗余转换任务的ID。该ID可以用于后续查看、删除存储冗余转换任务。

父节点:BucketDataRedundancyTransition

子节点:无

示例

  • 请求示例

    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>

错误码

错误码

HTTP状态码

描述

NoSuchBucket

404

创建存储冗余转换任务时,设置的Bucket不存在。

BucketDataRedundancyTransitionTaskNotSupport

400

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

BucketDataRedundancyTransitionTaskAlreadyExist

409

当前已存在存储冗余转换任务。

BucketDataRedundancyTransitionTaskExceedLimit

400

存储冗余转换任务太多,需要先删除已结束的任务再创建新任务。