すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:CreateBucketDataRedundancyTransition

最終更新日:Apr 30, 2026

バケットの冗長性タイプ変換タスクを作成します。

注意事項

  • バケットは、ストレージ冗長性タイプ変換をサポートするリージョンに存在している必要があります。サポートされているリージョンは以下のとおりです:中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深セン)、中国 (香港)、日本 (東京)、シンガポール、インドネシア (ジャカルタ)、ドイツ (フランクフルト)

  • バケットのストレージ冗長性タイプは LRS である必要があります。OSS では、LRS から ZRS への変換のみがサポートされています。

  • バケットのストレージクラスは、標準ストレージ、低頻度アクセス (IA)、またはアーカイブである必要があります。ただし、バケット内にコールドアーカイブストレージまたはディープコールドアーカイブストレージのオブジェクトが存在していても問題ありません。変換後も、これらのオブジェクトは引き続き LRS のままとなります。ストレージクラスがコールドアーカイブまたはディープコールドアーカイブのバケットについては、ストレージ冗長性タイプの変換は実行できません。

  • 冗長性タイプ変換タスクを作成するには、oss:CreateBucketDataRedundancyTransition 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーを付与する」をご参照ください。

  • リージョンとエンドポイントのマッピングについては、「エンドポイント」をご参照ください。

リクエスト構文

POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

この操作では共通のリクエストヘッダーのみを使用します。詳細については、「共通のリクエストヘッダー」をご参照ください。

リクエストパラメーター

パラメーター

タイプ

必須

説明

x-oss-target-redundancy-type

String

はい

ZRS

変換先の冗長性タイプです。ローカル冗長ストレージ (LRS) からゾーン冗長ストレージ (ZRS) へ変換する場合は、この値を ZRS に設定します。

レスポンスヘッダー

この操作では共通のレスポンスヘッダーのみを使用します。詳細については、「共通のレスポンスヘッダー」をご参照ください。

レスポンス要素

パラメーター

タイプ

説明

BucketDataRedundancyTransition

コンテナ

N/A

冗長性タイプ変換タスクのコンテナです。

親要素:なし(ルート要素)

子要素:TaskId

TaskId

String

4be5beb0f74f490186311b268bf6****

冗長性タイプ変換タスクの ID です。この ID を使用して、タスクの照会や削除が可能です。

親要素:BucketDataRedundancyTransition

子要素:なし

  • リクエスト例

    POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 08:40:17 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • レスポンス例

    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>

ossutil

対応する ossutil コマンドについては、「create-bucket-data-redundancy-transition」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

NoSuchBucket

404

指定されたバケットが存在しません。

BucketDataRedundancyTransitionTaskNotSupport

400

バケットの冗長性タイプは変換できません。バケットは LRS から ZRS にのみ変換可能です。

BucketDataRedundancyTransitionTaskAlreadyExist

409

指定されたバケットに対して、すでに冗長性タイプ変換タスクが進行中です。

BucketDataRedundancyTransitionTaskExceedLimit

400

冗長性タイプ変換タスクの最大数に達しています。新しいタスクを作成するには、完了済みのタスクを削除する必要があります。

AccessDenied

403

バケットのリージョンでは、この操作がサポートされていません。