バケットの冗長型変換タスクを作成します。
使用上の注意
バケットが配置されているリージョンで冗長型変換がサポートされていることを確認してください。 この機能は、中国 (杭州) 、中国 (上海) 、中国 (北京) 、中国 (張家口) 、中国 (ウランカブ) 、中国 (深セン) 、中国 (香港) 、日本 (東京) 、シンガポール、インドネシア (ジャカルタ) 、ドイツ (フランクフルト) でサポートされています。
バケットの冗長タイプは、ローカル冗長ストレージ (LRS) である必要があります。 バケットの冗長タイプは、LRSからゾーン冗長ストレージ (ZRS) にのみ変換できます。
バケットのストレージクラスは、標準、低頻度アクセス (IA) 、またはアーカイブである必要があります。 ただし、バケット内のオブジェクトのストレージクラスは、コールドアーカイブまたはディープコールドアーカイブにすることができます。 Cold ArchiveオブジェクトとDeep Cold Archiveオブジェクトは、変更後もLRSとして保存されます。 Cold ArchiveバケットまたはDeep Cold Archiveバケットのストレージ冗長タイプを変更することはできません。
バケットの冗長型変換タスクを作成するには、
oss:CreateBucketDataRedundancyTransition
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。各リージョンには、独自のObject Storage Service (OSS) エンドポイントがあります。 リージョンとそのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。
リクエスト構文
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue
リクエストヘッダー
CreateBucketDataRedundancyTransitionリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
リクエストパラメーター
パラメーター | データ型 | 必須 | 例 | 説明 |
x-oss-target-redundancy-type | String | 必須 | ZRS | バケットを変換する冗長タイプ。 バケットの冗長タイプをLRSからZRSにのみ変換できます。 |
レスポンスヘッダー
CreateBucketDataRedundancyTransitionリクエストに対するレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 例 | 説明 |
BucketDataRedundancyTransition | Container | N/A | 冗長型変換タスクが格納されるコンテナ。 親ノード: なし 子ノード: TaskId |
タスクID | String | 4be5beb0f74f490186311b268bf6 **** | 冗長型変換タスクのID。 IDを使用して、冗長タイプの変換タスクを表示および削除できます。 親ノード: BucketDataRedundancyTransition 子ノード: なし |
例
リクエストの例
POST /?redundancyTransition&x-oss-target-redundancy-type=ZRS HTTP/1.1 ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com 日付: 11月17日金曜日2023 08:40:17 GMT 権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh 5wQgIjWjwO/KyRt8dOP ****
レスポンスの例
HTTP/1.1 200 x-oss-request-id: 655726F18EAD9B710C00B235 日付: 11月17日金曜日2023 08:40:17 GMT Content-Type: application/xml コンテンツ-長さ: 151 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <BucketDataRedundancyTransition> <TaskId>4be5beb0f74f490186311b268bf6 ****</TaskId> </BucketDataRedundancyTransition>
エラーコード
エラーコード | HTTPステータスコード | 説明 |
NoSuchBucket | 404 | 冗長型変換タスクを作成するバケットが存在しません。 |
BucketDataRedundancyTransitionTaskNotSupport | 400 | バケットの冗長タイプは変換できません。 バケットの冗長タイプをLRSからZRSにのみ変換できます。 |
BucketDataRedundancyTransitionTaskAlreadyExist | 409 | 冗長タイプの変換タスクが進行中です。 |
BucketDataRedundancyTransitionTaskExceedLimit | 400 | 冗長タイプの変換タスクの最大数に達しました。 新しいタスクを作成する前に、完了したタスクを削除します。 |