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

Object Storage Service:CreateBucketDataRedundancyTransition

最終更新日:Jun 10, 2025

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

使用上の注意

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

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

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