バケットの冗長性タイプ変換タスクを作成します。
使用上の注意
バケットが配置されているリージョンで冗長性タイプ変換がサポートされていることを確認してください。 この機能は、次のリージョンでサポートされています。中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (ウランチャブ)、中国 (深セン)、中国 (香港)、日本 (東京)、シンガポール、インドネシア (ジャカルタ)、ドイツ (フランクフルト)。
バケットの冗長性タイプは、ローカル冗長ストレージ (LRS) である必要があります。 バケットの冗長性タイプは、LRS からゾーン冗長ストレージ (ZRS) にのみ変換できます。
バケットのストレージタイプは、標準、低頻度アクセス (IA)、またはアーカイブである必要があります。 ただし、バケット内のオブジェクトのストレージタイプは、コールドアーカイブまたはディープコールドアーカイブにすることができます。 コールドアーカイブおよびディープコールドアーカイブのオブジェクトは、変更後も LRS として保存されます。 コールドアーカイブまたはディープコールドアーカイブバケットのストレージ冗長性タイプは変更できません。
バケットの冗長性タイプ変換タスクを作成するには、
oss:CreateBucketDataRedundancyTransition権限が必要です。 詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。各リージョンには、独自の Object Storage Service (OSS) エンドポイントがあります。 リージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
リクエスト構文
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストヘッダー
CreateBucketDataRedundancyTransition リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通のリクエストヘッダー」をご参照ください。
リクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
x-oss-target-redundancy-type | String | はい | ZRS | バケットを変換する冗長性タイプ。 バケットの冗長性タイプは、LRS から ZRS にのみ変換できます。 |
レスポンスヘッダー
CreateBucketDataRedundancyTransition リクエストへのレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通のレスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | タイプ | 例 | 説明 |
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
CreateBucketDataRedundancyTransition 操作に対応する ossutil コマンドについては、「create-bucket-data-redundancy-transition」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchBucket | 404 | 冗長性タイプ変換タスクが作成されるバケットが存在しません。 |
BucketDataRedundancyTransitionTaskNotSupport | 400 | バケットの冗長性タイプを変換できません。 バケットの冗長性タイプは、LRS から ZRS にのみ変換できます。 |
BucketDataRedundancyTransitionTaskAlreadyExist | 409 | 冗長性タイプ変換タスクが進行中です。 |
BucketDataRedundancyTransitionTaskExceedLimit | 400 | 冗長性タイプ変換タスクの最大数に達しました。 新しいタスクを作成する前に、完了したタスクを削除してください。 |