DescribeMigrateTasks
调用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 |
备份数据上云任务类型,取值:
|
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 |
备份数据上云任务的状态,取值:
|
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
}
错误码
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论