バケットの冗長性タイプ変更タスクをクエリします。
使用方法
バケットの冗長性タイプ変更タスクをクエリするには、
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 日付
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 | 冗長性タイプ変更タスクの状態です。有効な値:
親ノード: 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 | 冗長性タイプ変更タスクが存在しません。 |