CreateBucketDataRedundancyTransition
調(diào)用CreateBucketDataRedundancyTransition接口為Bucket創(chuàng)建存儲(chǔ)冗余轉(zhuǎn)換任務(wù)。
注意事項(xiàng)
Bucket所屬地域支持轉(zhuǎn)換存儲(chǔ)冗余類型。支持轉(zhuǎn)換存儲(chǔ)冗余類型的地域:華東1(杭州)、華東2(上海)、華北2(北京)、華北 3(張家口)、華北6(烏蘭察布)、華南1(深圳)、中國(guó)香港、日本(東京)、新加坡、印度尼西亞(雅加達(dá))、德國(guó)(法蘭克福)
Bucket的存儲(chǔ)冗余類型必須為本地冗余存儲(chǔ)。OSS僅支持將本地冗余存儲(chǔ)轉(zhuǎn)換為同城冗余存儲(chǔ)。
Bucket的存儲(chǔ)類型必須為標(biāo)準(zhǔn)存儲(chǔ)、低頻訪問存儲(chǔ)或歸檔存儲(chǔ),但Bucket中的文件的存儲(chǔ)類型可以為冷歸檔存儲(chǔ)和深度冷歸檔存儲(chǔ)。冷歸檔存儲(chǔ)和深度冷歸檔存儲(chǔ)的文件轉(zhuǎn)換后依然為本地冗余存儲(chǔ)。冷歸檔存儲(chǔ)和深度冷歸檔存儲(chǔ)的Bucket不支持轉(zhuǎn)換存儲(chǔ)冗余類型。
要?jiǎng)?chuàng)建存儲(chǔ)冗余轉(zhuǎn)換任務(wù),您必須具有
oss:CreateBucketDataRedundancyTransition
權(quán)限。具體操作,請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。每個(gè)地域都有對(duì)應(yīng)的訪問域名(Endpoint)。關(guān)于地域與訪問域名對(duì)應(yīng)關(guān)系的更多信息,請(qǐng)參見訪問域名和數(shù)據(jù)中心。
請(qǐng)求語法
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue
請(qǐng)求頭
此接口僅涉及公共請(qǐng)求頭。更多信息,請(qǐng)參見公共請(qǐng)求頭(Common Request Headers)。
請(qǐng)求參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
x-oss-target-redundancy-type | 字符串 | 是 | ZRS | 目標(biāo)存儲(chǔ)冗余類型。OSS僅支持將LRS(本地冗余存儲(chǔ))轉(zhuǎn)換為ZRS(同城冗余存儲(chǔ))。 |
響應(yīng)頭
此接口僅涉及公共響應(yīng)頭。更多信息,請(qǐng)參見公共響應(yīng)頭(Common Response Headers)。
響應(yīng)元素
名稱 | 類型 | 示例值 | 描述 |
BucketDataRedundancyTransition | 容器 | 不涉及 | 存儲(chǔ)冗余轉(zhuǎn)換任務(wù)的容器。 父節(jié)點(diǎn):無 子節(jié)點(diǎn):TaskId |
TaskId | 字符串 | 4be5beb0f74f490186311b268bf6**** | 存儲(chǔ)冗余轉(zhuǎn)換任務(wù)的ID。該ID可以用于后續(xù)查看、刪除存儲(chǔ)冗余轉(zhuǎn)換任務(wù)。 父節(jié)點(diǎn):BucketDataRedundancyTransition 子節(jié)點(diǎn):無 |
示例
請(qǐng)求示例
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>
錯(cuò)誤碼
錯(cuò)誤碼 | HTTP狀態(tài)碼 | 描述 |
NoSuchBucket | 404 | 創(chuàng)建存儲(chǔ)冗余轉(zhuǎn)換任務(wù)時(shí),設(shè)置的Bucket不存在。 |
BucketDataRedundancyTransitionTaskNotSupport | 400 | Bucket的存儲(chǔ)冗余類型不支持轉(zhuǎn)換。OSS僅支持將本地冗余存儲(chǔ)轉(zhuǎn)換為同城冗余存儲(chǔ)。 |
BucketDataRedundancyTransitionTaskAlreadyExist | 409 | 當(dāng)前已存在存儲(chǔ)冗余轉(zhuǎn)換任務(wù)。 |
BucketDataRedundancyTransitionTaskExceedLimit | 400 | 存儲(chǔ)冗余轉(zhuǎn)換任務(wù)太多,需要先刪除已結(jié)束的任務(wù)再創(chuàng)建新任務(wù)。 |