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

Object Storage Service:GetBucketDataRedundancyTransition

最終更新日:Jan 02, 2025

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

使用上の注意

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

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

リクエスト構文

GET /?redundancyTransition&x-oss-redundancy-transition-taskid=xxx HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

リクエストヘッダー

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

x-oss-redundancy-transition-taskid

String

対象

751f5243f8ac4ae89f34726534d1 ****

冗長型変換タスクのID。

レスポンスヘッダー

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

レスポンス要素

要素

タイプ

説明

BucketDataRedundancyTransition

コンテナー

非該当

冗長型変換タスクが格納されるコンテナ。

親ノード: なし

子ノード: 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

非該当

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

親ノード: BucketDataRedundancyTransition

子ノード: なし

ステータス

String

処理中

冗長型変換タスクの状態。 有効な値:

  • キュー

  • 処理中

  • 終了

親ノード: BucketDataRedundancyTransition

子ノード: なし

EstimatedRemainingTime

Integer

100

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

親ノード: BucketDataRedundancyTransition

子ノード: なし

ProcessPercentage

Integer

0

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

親ノード: BucketDataRedundancyTransition

子ノード: なし

  • リクエストの例

    GET /?redundancyTransition&x-oss-redundancy-transition-taskid=909c6c818dd041d1a44e0fdc66aa**** HTTP/1.1
    Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
    Date: Fri, Nov 17 2023 09:14:39 GMT
    Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****
  • レスポンスの例

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

      HTTP/1.1 200 OK
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C0****
      Date: Fri, 17 Nov 2023 08:40:17 GMT
      Content-Type: application/xml
      Content-Length: 216
      
      <?xml version="1.0" encoding="UTF-8"?>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket</Bucket>
        <TaskId>4be5beb0f74f490186311b268bf6****</TaskId>
        <Status>Queueing</Status>
        <CreateTime>2023-11-17T09:11:58.000Z</CreateTime>
      </BucketDataRedundancyTransition>
    • 処理状態の冗長型変換タスクのサンプルレスポンス

      HTTP/1.1 200 OK
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00****
      Date: Fri, 17 Nov 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>
        <Status>Processing</Status>
        <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
      Server: AliyunOSS
      x-oss-request-id: 655726F18EAD9B710C00****
      Date: Fri, 17 Nov 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>
        <Status>Finished</Status>
        <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

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