调用DescribePreCheckProgressList接口,查看备份计划预检查进度和恢复任务预检查进度。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribePreCheckProgressList

系统规定参数。取值:DescribePreCheckProgressList。

BackupPlanId String dbstooi01XXXX

备份计划ID。

RestoreTaskId String dbasdsaXXXX

恢复任务ID。

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查询。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。

返回数据

名称 类型 示例值 描述
ErrCode String Param.NotFound

错误码。

Items Array of PreCheckProgressDetail

进度明细列表。

PreCheckProgressDetail
BootTime Long 1583734969000

启动时间,取值:1554560477000。

ErrMsg String java.lang.RuntimeException: Could not find any schema ......

异常信息。

FinishTime Long 1583734969000

完成时间,取值:1554560477000。

Item String CHECK_OTHER

检查项编码。

JobId String uvk8f6fxnq5s

进度ID。

Names String CHECK_OTHER

检查项分组。

OrderNum String 10

序号。

State String warning

进度状态,取值

  • init:初始化
  • warning:失败
  • catched:异常
  • running:运行中
  • failed:失败
  • finish:完成
HttpStatusCode Integer 200

HTTP状态码。

ErrMessage String The specified parameter %s value is not valid.

错误信息。

Progress Integer 100

预检查进度。取值范围: 0~100。

RequestId String C4A45FE1-A903-470D-B113-F12A4DF942AB

请求ID。

Status String failed

预检查状态,取值:

  • running:运行中
  • failed:失败
  • finish:完成
Success Boolean true

是否成功。

示例

请求示例

http(s)://dbs-api.cn-hangzhou.aliyuncs.com/?Action=DescribePreCheckProgressList
&<公共请求参数>

正常返回示例

XML 格式

</DescribePreCheckProgressListReponse>
<Status>failed</Status>
<Progress>20</Progress>
<RequestId>C4A45FE1-A903-470D-B113-F12A4DF942AB</RequestId>
<HttpStatusCode>200</HttpStatusCode>
<Items>
    <PreCheckProgressDetail>
        <Names>CHECK_MYSQL_PASSOWRD_FORMAT_DETAIL</Names>
        <Item>CHECK_MYSQL_PASSOWRD_FORMAT</Item>
        <OrderNum>90</OrderNum>
        <State>init</State>
        <BootTime>1583734969000</BootTime>
        <JobId>uvk8f6fxnq5s</JobId>
    </PreCheckProgressDetail>
</Items>
<ErrMessage>java.lang.RuntimeException: Could not find any schema ......</ErrMessage>
<Success>true</Success>
</DescribePreCheckProgressListReponse>

JSON 格式

{
	"Status": "failed",
	"Progress": 20,
	"RequestId": "C4A45FE1-A903-470D-B113-F12A4DF942AB",
	"HttpStatusCode": 200,
	"Items": {
		"PreCheckProgressDetail": [
			{
				"Names": "CHECK_MYSQL_PASSOWRD_FORMAT_DETAIL",
				"Item": "CHECK_MYSQL_PASSOWRD_FORMAT",
				"OrderNum": "90",
				"State": "init",
				"BootTime": 1583734969000,
				"JobId": "uvk8f6fxnq5s"
			}
		]
	},
	"ErrMessage": "java.lang.RuntimeException: Could not find any schema ......",
	"Success": true
}

错误码

访问错误中心查看更多错误码。