调用DescribeMigrateTasks接口查询备份数据上云任务列表。

该接口可以查询实例在最近一周内的备份数据上云任务记录。

说明
  • 备份数据上云的源备份文件必须是全量备份（FULL）文件。
  • 暂不支持SQL Server 2017集群版实例。

调试

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

请求参数

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

系统规定参数，取值：DescribeMigrateTasks。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
StartTime String 是 2017-10-20T01:00Z

查询开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

EndTime String 是 2017-10-25T01:00Z

查询结束时间，必须大于开始时间。格式：yyyy-MM-ddTHH:mmZ（UTC时间）。

PageSize Integer 否 30

每页记录数，取值：30~100。默认值：30。

PageNumber Integer 否 1

页码，取值：大于0且不超过Integer的最大值。

默认值：1。

AccessKeyId String 否 LTAIfCxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。
Items Array

备份数据上云任务信息列表。
MigrateTask

备份数据上云任务信息列表。
BackupMode String FULL

备份数据上云任务类型，取值：

  • FULL：表示通过全量备份文件去执行还原操作。
  • UPDF：表示通过增量文件或者日志文件去还原增量部分的数据。
CreateTime String 2017-05-30T12:11:04Z

备份数据上云任务创建时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

DBName String testDB

数据库名称。
Description String Api description

备份数据上云任务的描述信息。
EndTime String 2017-05-30T13:11:04Z

备份数据上云任务结束时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

IsDBReplaced String True

是否是覆盖性导入。
MigrateTaskId String 564522545

备份数据上云任务的ID。
Status String Success

备份数据上云任务的状态，取值：

  • NoStart：未开始；
  • Running：运行中；
  • Success：成功；
  • Failed：失败；
  • Waiting：等待（等待增量备份文件导入）。
PageRecordCount Integer 10

每页记录数。
PageNumber Integer 1

获取第几页的数据。
RequestId String 4E356DDF-6B83-45DB-99D5-4B1E8A0D286B

请求ID。
TotalRecordCount Integer 30

满足条件的总的记录数。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTasks
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2017-10-20T01:00Z
&EndTime=2017-10-25T01:00Z
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeMigrateTasksResponse>
	  <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
	  <PageRecordCount>1</PageRecordCount>
	  <PageNumber>1</PageNumber>
	  <TotalRecordCount>10</TotalRecordCount>
	  <Items>
		    <MigrateTaskId>rm-bp1842vxxxxx</MigrateTaskId>
		    <DBName>test02</DBName>
		    <CreateTime>2017-05-30 T12:11:4Z</CreateTime>
		    <EndTime>2017-05-30 T12:11:4Z</EndTime>
		    <IsDBReplaced>True</IsDBReplaced>
		    <Status>Success</Status>
		    <BackupMode>FULL</BackupMode>
		    <Description>Api description</Description>
	  </Items></DescribeMigrateTasksResponse>

JSON 格式 

{
	"Items":{
		"Status":"Success",
		"MigrateTaskId":"rm-bp1842vxxxxx",
		"Description":"Api description",
		"IsDBReplaced":"True",
		"CreateTime":"2017-05-30 T12:11:4Z",
		"BackupMode":"FULL",
		"EndTime":"2017-05-30 T12:11:4Z",
		"DBName":"test02"
	},
	"TotalRecordCount":10,
	"PageNumber":1,
	"RequestId":"A5409D02-D661-4BF3-8F3D-0A814D0574E7",
	"PageRecordCount":1
}

错误码

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