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