バケットの冗長タイプ変更タスクを照会します。
使用上の注意
バケットの冗長型変更タスクをクエリするには、
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 | 冗長タイプの変更タスクは存在しません。 |