調用CreateBucketDataRedundancyTransition介面為Bucket建立儲存冗餘轉換任務。
注意事項
Bucket所屬地區支援轉換儲存冗餘類型。支援轉換儲存冗餘類型的地區:華東1(杭州)、華東2(上海)、華北2(北京)、華北 3(張家口)、華北6(烏蘭察布)、華南1(深圳)、中國香港、日本(東京)、新加坡、印尼(雅加達)、德國(法蘭克福)
Bucket的儲存冗餘類型必須為本地備援儲存體。OSS僅支援將本地備援儲存體轉換為同城冗餘儲存。
Bucket的儲存類型必須為標準儲存、低頻訪問儲存或Archive Storage,但Bucket中的檔案的儲存類型可以為冷Archive Storage和深度冷Archive Storage。冷Archive Storage和深度冷Archive Storage的檔案轉換後依然為本地備援儲存體。冷Archive Storage和深度冷Archive Storage的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 | 儲存冗餘轉換任務太多,需要先刪除已結束的任務再建立新任務。 |