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权限，具体授权信息请参考文档。

3. 解析返回结果：

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

4. 判断任务是否完成：

   • 根据ImportStatus字段的值来判断任务是否完成。如果状态为Success，则表示该导入任务已完成；若为其他状态，则根据具体状态进一步分析处理。

通过上述步骤，您可以系统地查询和监控SQL Server数据库的导入任务情况，并判断任务是否完成。