调用DescribeMigrateTaskById查询SQL Server的某个OSS备份上云任务的信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeMigrateTaskById

DBInstanceId String rm-bp11e1tzgxxxx4ox

RDS SQL Server实例ID。

MigrateTaskId String 235943

备份上云任务的ID,可以通过DescribeMigrateTasks接口查询。

ResourceGroupId String rg-acfmy*****

资源组ID。

返回数据

名称 类型 示例值 描述
Status String Success

备份数据上云任务的状态,取值:

  • NoStart:未开始
  • Running:运行中
  • Success:成功
  • Failed:失败
  • Waiting:等待增量备份文件导入
EndTime String 2021-05-30T15:15:05Z

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

DBInstanceName String rm-uf6wjk5xxxxxxxxxx

实例ID。

RequestId String 6ED3635A-01F9-47BD-B9C8-CB3FD70A336E

请求ID。

Description String Success to DBCC checkdb asynchronously

备份数据上云任务的描述信息。

CreateTime String 2020-05-30T12:11:04Z

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

DBName String mytestdb

数据库名称。

BackupMode String FULL

备份数据上云任务类型,取值:

  • FULL:表示通过全量备份文件去执行还原操作。
  • UPDF:表示通过增量文件或者日志文件去还原增量部分的数据。
MigrateTaskId String 235943

OSS备份上云任务的ID。

IsDBReplaced String False

是否是覆盖性导入。取值:

  • False:否
  • True:是

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeMigrateTaskById
&DBInstanceId=rm-bp11e1tzgxxxx4ox
&MigrateTaskId=235943
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeMigrateTaskByIdResponse>
  <Status>Success</Status>
  <Description>Success to DBCC checkdb asynchronously</Description>
  <RequestId>B994DF29-44A1-43FD-A693-917930DFEBCE</RequestId>
  <EndTime>2021-03-04T13:50:23Z</EndTime>
  <MigrateTaskId>235943</MigrateTaskId>
  <CreateTime>2021-03-04T13:47:17Z</CreateTime>
  <BackupMode>FULL</BackupMode>
  <DBName>mytestdb</DBName>
  <DBInstanceName>rm-bp11e1tzgxxxxx4ox</DBInstanceName>
</DescribeMigrateTaskByIdResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Status" : "Success",
  "Description" : "Success",
  "RequestId" : "6ED3635A-01F9-47BD-B9C8-CB3FD70A336E",
  "EndTime" : "2021-03-04T13:50:23Z",
  "MigrateTaskId" : "235943",
  "CreateTime" : "2021-03-04T13:47:17Z",
  "BackupMode" : "FULL",
  "DBName" : "mytestdb",
  "DBInstanceName" : "rm-bp11e1tzgxxxxx4ox"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidStartTimeAndEndTime.Malformed The end time must be greater than the start time. 操作失败,开始时间需早于结束时间。正确格式:开始时间为2011-05-30 T12:11:20Z,结束时间为2011-06-08 T12:09:20Z。
400 InvalidMigrateTask The specified MigrateTaskId 237360 does not exist. Please check again. 指定的迁移器237360不存在,请检查。
403 InvalidInstanceState The DB instance state does not support this operation. 操作失败,当前实例不可用。

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