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

Object Storage Service:CreateBucketDataRedundancyTransition

最終更新日:Feb 22, 2024

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

使用上の注意

  • バケットが配置されているリージョンで冗長型変換がサポートされていることを確認してください。 この機能は、中国 (杭州) 、中国 (上海) 、中国 (北京) 、中国 (張家口) 、中国 (ウランカブ) 、中国 (深セン) 、中国 (香港) 、日本 (東京) 、シンガポール、インドネシア (ジャカルタ) 、ドイツ (フランクフルト) でサポートされています。

  • バケットの冗長タイプは、ローカル冗長ストレージ (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

冗長タイプの変換タスクの最大数に達しました。 新しいタスクを作成する前に、完了したタスクを削除します。