调用DescribeOssDownloads接口查询RDS SQL Server备份数据上云任务的文件详情。

说明 该接口暂不支持SQL Server 2017企业版和2019 企业版实例。

调试

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

请求参数

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

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

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。可通过DescribeDBInstances接口查询。

MigrateTaskId String 是 5625458541

迁移任务的ID，可通过DescribeMigrateTasks接口查询。

返回数据

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

实例ID。
Items Array of OssDownload

导入的文件列表。
OssDownload
BackupMode String Database

备份类型，取值：

  • Database：全量备份文件
  • Differential_Database：增量备份文件
  • Transaction_Log：日志备份文件
CreateTime String 2017-08-17T12:45:15Z

备份文件在下载列表中的创建时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

Description String App description

文件描述信息。
EndTime String 2017-08-27T12:45:15Z

结束时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

FileName String test

备份文件在OSS上的名称。
FileSize String 2

备份文件大小，单位MB。
IsAvailable String True

是否可用，取值：True | False
Status String Finished

文件状态，取值：

  • NoStart：未开始
  • Downloading：下载中
  • Finished：下载完成
  • DownloadFailed：下载失败
  • VerifyFailed：MD5校验失败
  • Deleted：已删除
  • DeleteFailed：删除失败
  • CheckSuccess：检查成功
  • CheckFailed：检查失败
  • Restoring：还原中
  • Restored：还原成功
  • RestoreFailed：还原失败
MigrateTaskId String 562154852

迁移任务的ID。
RequestId String A5409D02-D661-4BF3-8F3D-0A814D0574E7

请求ID。

示例

请求示例

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

正常返回示例

XML格式 

<DescribeDBInstancesResponse>
      <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
      <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
      <MigrateTaskId>562154852</MigrateTaskId>
      <Items>
            <OssDownload>
                  <Status>Finished</Status>
                  <Description>App description</Description>
                  <EndTime>2017-08-27T12:45:15Z</EndTime>
                  <IsAvailable>True</IsAvailable>
                  <BackupMode>Database</BackupMode>
                  <CreateTime>2017-08-17T12:45:15Z</CreateTime>
                  <FileName>test</FileName>
                  <FileSize>2</FileSize>
            </OssDownload>
      </Items>
</DescribeDBInstancesResponse>

JSON格式 

{
    "DescribeDBInstancesResponse": {
        "RequestId": "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
        "DBInstanceId": "rm-uf6wjk5xxxxxxx",
        "MigrateTaskId": 562154852,
        "Items": {
            "OssDownload": {
                "Status": "Finished",
                "Description": "App description",
                "EndTime": "2017-08-27T12:45:15Z",
                "IsAvailable": "True",
                "BackupMode": "Database",
                "CreateTime": "2017-08-17T12:45:15Z",
                "FileName": "test",
                "FileSize": 2
            }
        }
    }
}

错误码

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