调用DescribeBackupSetDownloadTaskList接口查看支持查看DBS备份集下载列表。

调试

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

请求参数

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

系统规定参数。取值:DescribeBackupSetDownloadTaskList

BackupPlanId String dbs1hvb0wxxxxxx

备份计划ID。

BackupSetDownloadTaskId String dbstooi01exxxxx

备份集下载任务ID。

PageSize Integer 30

每页的记录数。取值:

  • 30(默认)
  • 50
  • 100
PageNum Integer 1

页码,大于等于0且不超过Integer的最大值,默认值为:0。

RegionId String cn-hangzhou

地域ID。您可以调用DescribeRegions查询。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

用于保证请求的幂等性,防止重复提交请求。

返回数据

名称 类型 示例值 描述
ErrCode String Param.NotFound

错误码。

ErrMessage String The specified parameter %s value is not valid.

错误信息。

HttpStatusCode Integer 200

HTTP状态码。

Items Array of BackupSetDownloadTaskDetail

备份计划详情。

BackupSetDownloadTaskDetail
BackupGatewayId Long 2134324232134

备份集备份网关、仅自动下载有值。

BackupPlanId String dbs1hvb0xxxx

备份计划ID。

BackupSetCode String UTF_8

源备份集编码。

  • 全量:同BackupSetId
  • 增量:增量文件名
BackupSetDataFormat String SQL

备份集下载数据格式:

  • Native
  • SQL
  • CSV
  • JSON
BackupSetDataSize Long 213

备份集数据大小。

BackupSetDbType String MySQL

数据库类型。

BackupSetDownloadCreateTime Long 1554560477000

创建时间戳,取值:1554560477000。

BackupSetDownloadDir String test

备份集下载服务器目录、仅自动下载有值。

BackupSetDownloadFinishTime Long 1554560477000

完成时间戳,取值:1554560477000。

BackupSetDownloadInternetUrl String 176.x.x.x

备份集公网下载地址,仅手工下载类型且转换完成的有值。

BackupSetDownloadIntranetUrl String 176.x.x.x

备份集内网下载地址,仅手工下载类型且转换完成的有值。

BackupSetDownloadStatus String init

备份集下载状态,取值:

  • checking:预检查中
  • init:预检查失败(未启动)
  • check_pass:预检查通过
  • pause:暂停
  • schedule:等待调度
  • running:运行中
  • stop:失败
  • finish:完成
BackupSetDownloadTargetType String agent

备份集下载目标类型 ,仅自动下载显示。

  • agent:备份网关。
BackupSetDownloadTaskId String dbstooxxxxx

备份集下载任务ID。

BackupSetDownloadTaskName String test

备份集下载任务名称。

BackupSetDownloadWay String auto

下载类型:

  • manual:手工
  • auto:自动
BackupSetId String dbsxxxxxx

源备份集ID。

BackupSetJobType String cbs_backup_sub_full

源备份集任务类型,取值:

  • cbs_backup_sub_full:逻辑全量任务
  • cbs_backup_sub_cont:逻辑增量任务
ErrMessage String java.lang.IndexOutOfBoundsException.

异常信息。

PageNum Integer 1

页码。

PageSize Integer 30

每页的记录数。

RequestId String BFE78B4D-7D57-43D8-ABCA-D11DED1F768E

请求ID。

Success Boolean true

是否成功。

TotalElements Integer 1

总备份集下载记录数。

TotalPages Integer 1

总页数。

示例

请求示例

http(s)://dbs-api.cn-hangzhou.aliyuncs.com/?Action=DescribeBackupSetDownloadTaskList
&BackupPlanId = dbs1hvb0wxxxxx
&<公共请求参数>

正常返回示例

XML格式

<DescribeBackupSetDownloadTaskListResponse>
  <RequestId>BFE78B4D-7D57-43D8-ABCA-D11DED1F768E</RequestId>
  <PageSize>30</PageSize>
  <PageNum>0</PageNum>
  <HttpStatusCode>200</HttpStatusCode>
  <TotalElements>0</TotalElements>
  <TotalPages>0</TotalPages>
  <Items></Items>
  <Success>true</Success>
</DescribeBackupSetDownloadTaskListResponse>

JSON格式

{
    "RequestId": "BFE78B4D-7D57-43D8-ABCA-D11DED1F768E",
    "PageSize": 30,
    "PageNum": 0,
    "HttpStatusCode": 200,
    "TotalElements": 0,
    "TotalPages": 0,
    "Items": "",
    "Success": true
}

错误码

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