全部產品
Search
文件中心

Object Storage Service:CreateBucketDataRedundancyTransition

更新時間:Jun 19, 2024

調用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

儲存冗餘轉換任務太多,需要先刪除已結束的任務再建立新任務。