API参考 - API参考 -SQL Server备份文件上云 -DescribeOssDownloads

为了查询数据上云任务详情，特别是针对SQL Server实例的全量备份文件迁移详情，您可以使用DescribeOssDownloads API接口。以下是操作指南及参数说明：

请求参数

1. Action: String, 必填** - 系统规定参数，固定取值为：DescribeOssDownloads`。
2. DBInstanceId: String, 必填** - 指定的RDS SQL Server实例ID。您可以通过DescribeDBInstances`接口获取实例ID。
3. MigrateTaskId: String, 必填** - 迁移任务的唯一标识ID，通过DescribeMigrateTasks`接口可以查询到相关任务ID。

返回参数概述

• DBInstanceId: 实例ID。
• MigrateTaskId: 迁移任务的ID。
• Items: 一个列表，包含关于导入记录项的详细信息。

Items 数据集合参数细节

对于每一条导入记录（即迁移的备份文件），返回参数包括但不限于： - FileName: 备份文件在OSS上的名称。 - CreateTime: 文件在下载列表中的创建时间，格式为yyyy-MM-ddTHH:mm:ssZ（UTC时间）。 - BackupMode: 迁移上云任务类型，根据您的需求说明，这里仅支持FULL，表示全量备份文件一次性迁入。 - FileSize: 备份文件大小，单位MB。 - Status: 文件状态，可能的状态有NoStart、Downloading、Finished等，具体可参考API文档以获取全部状态列表。 - IsAvailable: 表示文件是否可用，True表示可用，False表示不可用。 - Description: 文件描述信息，提供额外的上下文或备注。

注意事项

• 请确保请求中指定的实例ID和迁移任务ID正确无误。
• 目前此接口仅适用于SQL Server实例，并且限制于处理全量备份（FULL）文件的迁移任务。
• 查看具体错误码和变更历史，虽然此处未直接列出，但建议访问阿里云官方文档页面以获取最新和详细的错误码解释及接口变更信息。

通过调用DescribeOssDownloads接口并提供必要的参数，您可以获取到SQL Server实例数据上云任务的详细文件信息，包括但不限于文件名、创建时间、备份模式、文件大小、状态以及是否可用等关键信息。