All Products
Document Center


Last Updated: Mar 27, 2020


You can call this operation to query incremental backup tasks.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set the value to DescribeIncrementBackupList.
BackupPlanId String Yes The ID of the backup schedule.
PageSize Integer No The number of entries to return on each page. Valid values: 30, 50, and 100. Default value: 30.
PageNum Integer No The number of the page to return. It must be greater than or equal to 0 and smaller than or equal to the maximum value of the Integer type. Default value: 0.

Response parameters

Parameter Type Description
Items List The details of the incremental backup task. For more information, see the description of the IncrementBackupFile parameter.
TotalPages Integer The total number of pages returned.
PageSize Integer The number of entries returned per page.
PageNum Integer The number of the page returned.
TotalElements Long The total number of incremental backup tasks returned.


Parameter Type Description
BackupSetId String The ID of the backup set.
SourceEndpointIpPort String The connection endpoint of the database.
StartTime Long The start time of the backup. Example: 1554560477000.
EndTime Long The end time of the backup. Example: 1554560477000.
BackupStatus String The status of the backup task. Valid values:
  • INIT: The backup task was not started.
  • FILLING: The backup task was in progress.
  • COMPLETED: The backup task was completed.
  • UNCOMPLETED: The backup task was not completed.
BackupSetExpiredTime Long The expiration time of the backup set. Example: 1554560477000.
BackupSize Long The size of the backup set.
StorageMethod String The storage class of the backup data. Valid values:
  • Standard: standard storage.
  • IA: infrequent access storage.
  • Archive: archived storage.
  • UNKNOWN: unknown storage, which generally indicates that the backup task is not yet finished.

Error codes

Error code Error message Description
BackupFileNotDescribe Increment Backup not Describe. The error message returned because the incremental backup tasks cannot be queried.