调用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 | 存储冗余转换任务太多,需要先删除已结束的任务再创建新任务。 |