DescribeBackupTasks操作を呼び出して、ApsaraDB RDSインスタンスのバックアップタスクを照会できます。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | DescribeBackupTasks | 実行したい操作。 値をDescribeBackupTasksに設定します。 |
DBInstanceId | String | 必須 | rm-uf6wjk5xxxxxxx | インスタンスの ID です。 |
ClientToken | String | 任意 | ETnLKlblzczshOTUbOCzxxxxxxx | リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意である必要があります。 トークンにはASCII文字のみを使用でき、長さは64文字を超えることはできません。 |
フラグ | String | 任意 | なし | 非表示のパラメーター。 |
BackupJobId | Integer | いいえ | 4762614 | 照会する単一のバックアップタスクのID。 |
BackupMode | String | 任意 | Automated | 照会するバックアップタスクによって使用されるバックアップモード。 有効な値:
|
BackupJobStatus | String | 任意 | NoStart | 照会するバックアップタスクのステータス。 有効な値:
既定では、この操作は両方の状態のバックアップタスクを返します。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
項目 | BackupJobの配列 | バックアップタスクで構成される配列。 |
|
BackupJob | |||
BackupId | String | 346650271 | バックアップタスクによって生成されるバックアップセットのID。 説明 BackupStatusパラメーターの戻り値がFinishedの場合、BackupJobIdパラメーターを指定して、生成されたバックアップセットのIDを取得する必要があります。 |
BackupJobId | String | 4762614 | バックアップタスクのID。 |
BackupProgressStatus | String | NoStart | バックアッププログラムのステータス。 有効な値:
|
BackupStatus | String | NoStart | バックアップタスクのステータス。 有効な値:
説明 このパラメーターは、バックアップタスクが実行された場合にのみ返されます。 |
JobMode | String | Automated | バックアップタスクのバックアップモード。 有効な値:
|
処理中 | String | 25 | バックアップタスクの進行状況。 単位: % 。 |
TaskAction | String | NormalBackupTask | バックアップタスクのタイプ。 有効な値:
|
RequestId | String | 90496720-2319-42A8-87CD-FCE4DF95EBED | リクエストの ID です。 |
例
リクエストの例
http(s)://rds.aliyuncs.com/? アクション=DescribeBackupTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<DescribeBackupTasksResponse>
<アイテム>
<BackupJob>
<JobMode> 自動化 </JobMode>
<BackupProgressStatus>NoStart</BackupProgressStatus>
<TaskAction>NormalBackupTask</TaskAction>
<BackupStatus>NoStart</BackupStatus>
<BackupJobId>4762614</BackupJobId>
</BackupJob>
</アイテム>
<RequestId>90496720-2319-42A8-87CD-FCE4DF95EBED</RequestId>
</DescribeBackupTasksResponse>
JSON
形式
{
"Items": {
"BackupJob": [
{
"JobMode": "自動化" 、
"BackupProgressStatus": "NoStart" 、
"TaskAction": "NormalBackupTask" 、
"BackupStatus": "NoStart" 、
"BackupJobId": 4762614
}
]
},
"RequestId": "90496720-2319-42A8-87CD-FCE4DF95EBED"
}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。