API参考 - API参考 - 数据迁移 - DescribeImportsForSQLServer

为了查看SQL Server数据库的导入列表并检查导入任务情况，您可以按照以下步骤操作：

1. 构造请求参数：

   • Action: 必须参数，固定值为DescribeImportsForSQLServer。
   • DBInstanceId: 是实例名，您需要提供目标SQL Server数据库实例的ID。
   • ImportId: （可选）如果已知，可以指定迁移结果ID来查询特定的导入任务。
   • StartTime: 查询开始时间，格式如：2011-06-11T15:00Z。确保该时间早于或等于您想查询的任务开始时间。
   • EndTime: 查询结束时间，格式如：2011-06-11T16:00Z，且需晚于查询开始时间。
   • PageSize: （可选）每页记录数，默认值为30，可选值为30/50/100。
   • PageNumber: （可选）页码，默认值为1。

2. 发起API调用：

   • 使用构造好的请求参数，通过HTTP GET请求访问RDS API端点。示例请求URL如下（请替换实际参数值）：

     https://rds.aliyuncs.com/
     ?Action=DescribeImportsForSQLServer
     &DBInstanceId=您的实例ID
     &StartTime=查询开始时间
     &EndTime=查询结束时间
     &PageSize=每页记录数
     &PageNumber=页码
     

   • 确保在调用API前，您已经具备了相应的RAM权限，具体授权信息可参考文档中关于DescribeImportsForSQLServer的说明。

3. 解析返回结果：

   • API响应将包含以下关键信息：
     • TotalRecordCount: 总记录数，表示所有匹配查询条件的导入任务数量。
     • PageNumber: 当前页码。
     • PageRecordCount: 本页显示的SQL Server导入任务个数。
     • Items: 一个列表，包含每个导入任务的详细信息，如：
     • ImportId: 迁移ID。
     • FileName: 导入文件名。
     • DBName: 导入的数据库名。
     • ImportStatus: 导入状态，可能的取值包括：
       • Pending: 未开始
       • Importing: 导入中
       • Success: 导入成功
       • Failed: 导入失败
       • Cancelled: 任务取消
       • Cancelling: 迁移取消中
     • StartTime: 导入开始时间，格式为YYYY-MM-DD’T’HH:mm:ssZ。

4. 判断任务是否完成：

   • 根据ImportStatus字段的值，您可以直接判断导入任务的状态。如果状态为Success，则表示导入任务已完成；如果为Failed、Cancelled或Cancelling，则表示任务未成功完成；如果为Pending或Importing，则任务仍在进行中。

通过上述步骤，您可以系统地查询SQL Server数据库的导入任务列表，并根据返回的信息判断各个任务的完成情况。