开发者社区 问答 正文

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




查看文件服务器的文件列表。通过“获取文件上传地址”接口,您可以得到文件服务器上传账号。在数据文件上传结束后,RDS会更新数据文件状态。然后通过本接口,可以查看数据文件是否可用。如果文件可用,则可以进行数据导入,并得到导入过程信息。

请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值: DescribeFilesForSQLServer。DBInstanceIdString是实例名。StartTimeString是查询开始时间,格式如:2011-06-11T15:00Z。EndTimeString是查询结束时间,格式如:2011-06-11T16:00Z,且大于查询开始时间。PageSizeInteger否每页记录数,取值:30/50/100默认值:30。PageNumberInteger否页码,大于0且不超过Integer的最大值;默认值:1。

返回参数

[tr=rgb(51, 205, 229)][td]名称 类型描述DBInstanceIdString实例名称。TotalRecordCountInteger总记录数。PageNumberInteger页码。PageRecordCountInteger本页SQL语句个数。ItemsList<SQLServerUploadFile>

SQLServerUploadFile参数

[tr=rgb(51, 205, 229)][td]名称 类型描述DBNameString数据库名。FileNameString数据文件名,带扩展名。FileSizeLong数据文件大小,单位:Byte。InternetFtpServerString文件服务器。InternetPortInteger文件服务器端口。IntranetFtpserverString内网服务器地址。IntranetportInteger内网服务器端口。UserNameString文件服务器账号。PasswordString文件服务器账号密码。FileStatusString文件状态。
  • Unavailable:不可用
  • Available:可用
  • NotStarted:未开始
  • Uploading:正在上传
  • UploadFailed:上传失败
  • Virus:有病毒
  • Deleted:文件被删除
  • Success:上传成功
CreationTimeStringFTP文件生成时间,格式为YYYY-MM-DD’T’HH:mm:ssZ,如2011-05-30 T12:11:4Z。

请求示例

https: //rds.aliyuncs.com/?Action=DescribeFilesForSQLServer &DBInstanceId=rianeurbfaeuq2u2a1370572118496 &StartTime=2014-06-11T15:00Z &EndTime=2014-06-11T16:00Z &<公共请求参数>

返回示例

XML格式 < DescribeFilesForSQLServerResponse> <RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828 </RequestId> <TotalRecordCount>1 </TotalRecordCount> <PageNumber>1 </PageNumber> <PageRecordCount>1 <PageRecordCount> <Items> <SQLServerUploadFile> <DBName>testdb01 </DBName> <FileName>testdb01_1370572475975.bak </FileName> <FileSize>1243435 </FileSize> <InternetFtpServer>10.230.239.1 </InternetFtpServer> <InternetPort>3021 </InternetPort> <IntranetFtpServer> </IntranetFtpServer> <IntranetPort> </IntranetPort> <UserName>MKEakJbyG </UserName> <Password>aT2Y_XN1GGnOLzm </Password> <FileStatus>Success </FileStatus> <CreationTime>2014-06-11T15:02:40Z </CreationTime> </SQLServerUploadFile> </Items> </DescribeFilesForSQLServerResponse>JSON格式{"PageNumber": 1,"TotalRecordCount": 1,"PageRecordCount": 1 "Items":{"SQLServerUploadFile":[{"DBName": "testdb01" "FileName": "testdb01_1370572475975.bak" "FileSize ": "1243435" "InternetFtpServer ": "10.230.239.1" "InternetPort": 3021 "IntranetFtpServer": "" "IntranetPort": "UserName": "MKEakJbyG" "Password": "aT2Y_XN1GGnOLzm" "FileStatus": "Success " "CreationTime": "2014-06-11T15:02:40Z"}]},"RequestId": "08A3B71B-FE08-4B03-974F-CC7EA6DB1828"}

展开
收起
梨好橙 2018-09-16 22:37:34 1443 分享 版权
阿里云 AI 助理回答

要查看文件服务器的文件列表,特别是针对RDS SQL Server实例的数据文件上传状态,您可以使用DescribeFilesForSQLServer接口。以下是操作步骤和关键参数说明:

请求调用步骤

  1. 构造请求

    • Action: 必须设置为DescribeFilesForSQLServer
    • DBInstanceId: 指定需要查询的RDS SQL Server实例名。
    • StartTime: 设置查询的开始时间,格式为YYYY-MM-DDThh:mmZ(例如:2011-06-11T15:00Z)。
    • EndTime: 设置查询的结束时间,需晚于开始时间,格式同上。
    • PageSize(可选): 每页记录数,默认30,可选值为30/50/100。
    • PageNumber(可选): 页码,默认为1,需大于0。
  2. 发送请求

    • 使用构造好的URL(示例:https://rds.aliyuncs.com/?Action=DescribeFilesForSQLServer&其他参数...)发起HTTP GET请求。确保您已具备访问该API所需的权限配置。
  3. 处理响应

    • 接口返回将包含以下信息:
      • TotalRecordCount: 总记录数。
      • PageNumber: 当前页码。
      • PageRecordCount: 本页数据文件数量。
      • Items.List: 文件列表,每项包含:
      • DBName: 数据库名。
      • FileName: 数据文件名,含扩展名。
      • FileSize: 文件大小(单位:Byte)。
      • InternetFtpServer, IntranetFtpServer: 对应内外网文件服务器地址。
      • InternetPort, IntranetPort: 文件服务器端口。
      • UserName, Password: 文件服务器账号及密码。
      • FileStatus: 文件状态,包括但不限于 Unavailable, Available, NotStarted, Uploading, UploadFailed, Virus, Deleted, Success
      • CreationTime: FTP文件生成时间。

注意事项

  • 确保调用API的RAM用户或角色已授权rds:DescribeFilesForSQLServer权限。
  • 根据实际需求调整查询时间范围和分页参数以获取期望的结果集。
  • 关注FileStatus字段来判断文件是否可用,只有当状态为Available时,文件才可进行后续的数据导入操作。

通过上述步骤,您可以有效地查询并管理RDS SQL Server实例跨地域数据备份文件的状态与详情。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答