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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
DBInstanceId String rm-bp11e1tzgxxxx4ox

RDS SQL Server实例ID。

MigrateTaskId String 235943

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

返回数据

名称 类型 示例值 描述
BackupMode String FULL

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

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

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

DBInstanceName String rm-uf6wjk5xxxxxxxxxx

实例ID。

DBName String mytestdb

数据库名称。

Description String Success to DBCC checkdb asynchronously

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

EndTime String 2021-05-30T12:11:04Z

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

IsDBReplaced String False

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

  • False:否
  • True:是
MigrateTaskId String 235943

OSS备份上云任务的ID。

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

请求ID。

Status String Success

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

  • NoStart:未开始
  • Running:运行中
  • Success:成功
  • Failed:失败
  • Waiting:等待(等待增量备份文件导入)

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeMigrateTaskById
&DBInstanceId=rm-bp11e1tzgxxxx4ox
&MigrateTaskId=235943
&<公共请求参数>

正常返回示例

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格式

{
  "Status": "Success",
  "Description": "Success",
  "RequestId": "6ED3635A-01F9-47BD-B9C8-CB3FD70A336E",
  "EndTime": "2021-03-04T13:47:58Z",
  "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不存在,请检查。

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