调用DescribeIncrementBackupList接口查看DBS增量备份任务列表。

调试

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

请求参数

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

系统规定参数,取值:DescribeIncrementBackupList

BackupPlanId String dbs1hvb0wwXXXXX

备份计划ID。

PageSize Integer 30

每页的记录数,取值:

  • 30
  • 50
  • 100
说明 默认为30。
PageNum Integer 1

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

RegionId String cn-hangzhou

地域ID,调用DescribeRegions接口查看DBS支持地域。

ClientToken String ETnLKlblzczshOTUbOCzxxxxxxx

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

ShowStorageType Boolean true

是否显示存储类型。

说明 默认true。

返回数据

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

错误码。

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

错误信息。

HttpStatusCode Integer 200

HTTP状态码。

Items Array of IncrementBackupFile

增量备份任务详情。

IncrementBackupFile
BackupSetExpiredTime Long 1554560477000

备份集保留到期时间戳。取值1554560477000。

BackupSetId String dbs1XXXXX

备份集ID。

BackupSize Long 100

备份大小。

BackupStatus String INIT

备份任务状态,取值:

  • INIT:未启动
  • FILLING:备份中
  • COMPLETED:完成
  • UNCOMPLETED:未完成
EndTime Long 1554560477000

备份结束时间戳。取值:1554560477000。

SourceEndpointIpPort String 100.X.X.10:33204

数据库连接地址。

StartTime Long 1554560477000

备份开始时间戳。取值:1554560477000。

StorageMethod String Standard

存储类型,取值:

  • Standard:标准存储
  • IA:低频访问存储
  • Archive:归档存储
  • UNKNOWN:未知,通常是任务未完成时的状态
PageNum Integer 1

页码。

PageSize Integer 30

每页的记录数。

RequestId String E161C346-5BE3-4E37-BCE8-6A86FB12E132

请求ID。

Success Boolean true

是否成功。

TotalElements Integer 1

增量备份任务总数。

TotalPages Integer 1

总页数。

示例

请求示例

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

正常返回示例

XML 格式

<DescribeIncrementBackupListResponse>
  <RequestId>E161C346-5BE3-4E37-BCE8-6A86FB12E132</RequestId>
  <PageSize>30</PageSize>
  <PageNum>0</PageNum>
  <HttpStatusCode>200</HttpStatusCode>
  <TotalElements>1</TotalElements>
  <TotalPages>1</TotalPages>
  <Items>
        <IncrementBackupFile>
              <SourceEndpointIpPort>100.X.X.10:33204</SourceEndpointIpPort>
              <StorageMethod>Standard</StorageMethod>
              <EndTime>1583742490000</EndTime>
              <BackupSize>4908210</BackupSize>
              <StartTime>1583721876000</StartTime>
              <BackupSetExpiredTime>1646814495000</BackupSetExpiredTime>
              <BackupSetId>mysql-bin.000003</BackupSetId>
              <BackupStatus>FILLING</BackupStatus>
        </IncrementBackupFile>
  </Items>
  <Success>true</Success>
</DescribeIncrementBackupListResponse>

JSON 格式

{
	"RequestId": "E161C346-5BE3-4E37-BCE8-6A86FB12E132",
	"PageSize": 30,
	"PageNum": 0,
	"HttpStatusCode": 200,
	"TotalElements": 1,
	"TotalPages": 1,
	"Items": {
		"IncrementBackupFile": [
			{
				"SourceEndpointIpPort": "100.X.X.10:33204",
				"StorageMethod": "Standard",
				"EndTime": 1583742490000,
				"BackupSize": 4908210,
				"StartTime": 1583721876000,
				"BackupSetExpiredTime": 1646814495000,
				"BackupSetId": "mysql-bin.000003",
				"BackupStatus": "FILLING"
			}
		]
	},
	"Success": true
}

错误码

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