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

Object Storage Service:GetBucketDataRedundancyTransition

最終更新日:Jun 09, 2025

バケットの冗長性タイプ変更タスクをクエリします。

使用方法

リクエスト構文

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

リクエストヘッダー

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

リクエストパラメーター

パラメーター

タイプ

必須

説明

x-oss-redundancy-transition-taskid

String

はい

751f5243f8ac4ae89f34726534d1****

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

レスポンスヘッダー

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

レスポンス要素

要素

タイプ

説明

BucketDataRedundancyTransition

コンテナー

該当なし

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

親ノード: なし

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

TaskId

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

子ノード: なし

Status

String

Processing

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

  • Queueing

  • Processing

  • Finished

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

ossutil

GetBucketDataRedundancyTransition 操作に対応する ossutil コマンドについては、「get-bucket-data-redundancy-transition」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

NoSuchBucket

404

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

BucketDataRedundancyTransitionTaskNotExist

404

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