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

Object Storage Service:GetBucketDataRedundancyTransition

最終更新日:Feb 22, 2024

バケットの冗長タイプ変更タスクを照会します。

使用上の注意

  • バケットの冗長型変更タスクをクエリするには、oss:GetBucketDataRedundancyTransition権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

  • 各リージョンには、独自のObject Storage Service (OSS) エンドポイントがあります。 リージョンとそのエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

リクエスト構文

GET /?redundancyTransition&x-oss-redundancy-transition-taskid=xxx HTTP/1.1
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
日付: GMT日付
権限付与: SignatureValue 

リクエストヘッダー

GetBucketDataRedundancyTransitionリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。

リクエストパラメーター

パラメーター

データ型

必須

説明

x-oss-redundancy-transition-taskid

String

必須

751f5243f8ac4ae89f34726534d1 ****

冗長タイプ変更タスクのID。

レスポンスヘッダー

GetBucketDataRedundancyTransitionリクエストに対するレスポンスのすべてのヘッダーは、共通のレスポンスヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。

レスポンス要素

要素

データ型

説明

BucketDataRedundancyTransition

Container

N/A

冗長タイプの変更タスクが格納されているコンテナ。

親ノード: なし

子ノード: TaskId、CreateTime、StartTime、EndTime、Status、EstimatedRemainingTime、およびProcessPercentage

タスクID

String

909c6c818dd041d1a44e0fdc66aa ****

冗長タイプ変更タスクのID。

親ノード: BucketDataRedundancyTransition

子ノード: なし

CreateTime

String

2023-11-17T09:14:39.000Z

冗長タイプの変更タスクが作成された時刻。

親ノード: BucketDataRedundancyTransition

子ノード: なし

StartTime

String

2023-11-17T09:14:39.000Z

冗長タイプの変更タスクが実行された時刻。 この要素は、タスクが [処理中] または [完了] 状態のときに使用できます。

親ノード: BucketDataRedundancyTransition

子ノード: なし

EndTime

String

N/A

冗長タイプの変更タスクが終了した時刻。 この要素は、タスクが完了状態のときに使用できます。

親ノード: BucketDataRedundancyTransition

子ノード: なし

ステータス

String

処理中

冗長タイプ変更タスクの状態。 有効な値:

  • キュー

  • 処理中

  • 終了

親ノード: BucketDataRedundancyTransition

子ノード: なし

EstimatedRemainingTime

Integer

100

冗長タイプの変更タスクに必要な推定期間。 単位:時間。 この要素は、タスクが [処理中] または [完了] 状態のときに使用できます。

親ノード: BucketDataRedundancyTransition

子ノード: なし

ProcessPercentage

Integer

0

冗長タイプ変更タスクの進行状況をパーセンテージで示します。 有効値: 0~100。 この要素は、タスクが [処理中] または [完了] 状態のときに使用できます。

親ノード: BucketDataRedundancyTransition

子ノード: なし

  • リクエストの例

    GET /?redundancyTransition&x-oss-redundancy-transition-taskid=909c6c818dd041d1a44e0fdc66aa **** HTTP/1.1
    ホスト: examplebucket.oss-cn-hangzhou.aliyuncs.com
    日付: 11月17日金曜日2023 09:14:39 GMT
    権限付与: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh 5wQgIjWjwO/KyRt8dOP **** 
  • レスポンスの例

    • キュー状態の冗長タイプ変更タスクのサンプル応答

      HTTP/1.1 200 OK
      サーバー: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C0 ****
      日付: 11月17日金曜日2023 08:40:17 GMT
      Content-Type: application/xml
      コンテンツ-長さ: 216
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>4be5beb0f74f490186311b268bf6 ****</TaskId>
        <ステータス> キュー </ステータス>
        <CreateTime>2023-11-17T09:11:58.000Z</CreateTime>
      </BucketDataRedundancyTransition> 
    • 処理状態の冗長タイプ変更タスクのサンプル応答

      HTTP/1.1 200 OK
      サーバー: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00 ****
      日付: 11月17日金曜日2023 08:40:17 GMT
      Content-type: application/xml
      Content-length: 397
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>909c6c818dd041d1a44e0fdc66aa ****</TaskId>
        <ステータス> 処理 </ステータス>
        <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
        <StartTime>2023-11-17T09:14:39.000Z</StartTime>
        <ProcessPercentage>0</ProcessPercentage>
        <EstimatedRemainingTime>100</EstimatedRemainingTime>
      </BucketDataRedundancyTransition> 
    • 完了状態の冗長タイプ変更タスクのサンプル応答

      HTTP/1.1 200 OK
      サーバー: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00 ****
      日付: 11月17日金曜日2023 08:40:17 GMT
      Content-type: application/xml
      Content-length: 420
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>909c6c818dd041d1a44e0fdc66aa ****</TaskId>
        <ステータス> 終了 </ステータス>
        <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
        <StartTime>2023-11-17T09:14:39.000Z</StartTime>
        <ProcessPercentage>100</ProcessPercentage>
        <EstimatedRemainingTime>0</EstimatedRemainingTime>
        <EndTime>2023-11-18T09:14:39.000Z</EndTime>
      </BucketDataRedundancyTransition> 

エラーコード

エラーコード

HTTPステータスコード

説明

NoSuchBucket

404

クエリする冗長性タイプの変更タスクを持つバケットが存在しません。

BucketDataRedundancyTransitionTaskNotExist

404

冗長タイプの変更タスクは存在しません。