调用DescribeBackupSets接口查询备份集信息。

调试

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

请求参数

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

系统规定参数,取值为DescribeBackupSets。

DrdsInstanceId String drds***********

DRDS实例ID。

EndTime String 1591326000000

查询结束时间,格式为时间戳(单位为毫秒)。

说明 查询结束时间需晚于查询开始时间
StartTime String 1591327800000

查询开始时间,格式为时间戳(单位为毫秒)。

返回数据

名称 类型 示例值 描述
BackupSets Array

备份集列表。

backupSet
BackupConsitentTime String 2020-06-05 11:31:38

备份恢复持续时间。

BackupDbs List ["dts********"]

备份的数据库列表。

BackupEndTime Long 1591327899000

备份结束时间,格式为时间戳(单位为毫秒)。

说明 0表示未结束。
BackupLevel String instance

备份级别,取值范围如下:

  • db:数据库级别
  • instance:实例级别
BackupMode String logic

备份方式,取值范围如下:

  • logic:逻辑备份
  • phy:快速备份
BackupStartTime Long 1591327754000

备份开始时间,格式为时间戳(单位为毫秒)。

BackupTotalSize String 93.24

备份集大小,单位为M。

BackupType String manual

备份类型,取值范围如下:

  • manual:手动备份
  • auto:自动备份
EnableRecovery Boolean false

该备份集是否可恢复。

Id String ba30d5c4-a6dc-11ea-bd40-************

备份集ID。

Status Long 2

备份状态,取值范围如下:

  • -1:失败
  • 0:未开始
  • 1:运行中
  • 2:成功
RequestId String 7103AEE3-9025-442F-B82B-BABD0A******

请求ID。

Success Boolean true

请求结果。

示例

请求示例

http(s)://drds.aliyuncs.com/?Action=DescribeBackupSets
&DrdsInstanceId=drds***********
&EndTime=1591326000000
&StartTime=1591327800000
&<公共请求参数>

正常返回示例

XML 格式

<RequestId>7103AEE3-9025-442F-B82B-BABD0A******</RequestId>
<BackupSets>
    <backupSet>
        <Status>2</Status>
        <BackupTotalSize>93.24</BackupTotalSize>
        <BackupConsitentTime>2020-06-05 11:31:38</BackupConsitentTime>
        <BackupEndTime>1591327899000</BackupEndTime>
        <BackupMode>logic</BackupMode>
        <BackupLevel>instance</BackupLevel>
        <BackupStartTime>1591327754000</BackupStartTime>
        <BackupType>manual</BackupType>
        <BackupDbs>
            <backupDb>dts********</backupDb>
        </BackupDbs>
        <Id>ba30d5c4-a6dc-11ea-bd40-************</Id>
        <EnableRecovery>true</EnableRecovery>
    </backupSet>
</BackupSets>
<Success>true</Success>

JSON 格式

{
	"RequestId": "7103AEE3-9025-442F-B82B-BABD0A******",
	"BackupSets": {
		"backupSet": [
			{
				"Status": 2,
				"BackupTotalSize": "93.24",
				"BackupConsitentTime": "2020-06-05 11:31:38",
				"BackupEndTime": 1591327899000,
				"BackupMode": "logic",
				"BackupLevel": "instance",
				"BackupStartTime": 1591327754000,
				"BackupType": "manual",
				"BackupDbs": {
					"backupDb": [
						"dts********"
					]
				},
				"Id": "ba30d5c4-a6dc-11ea-bd40-************",
				"EnableRecovery": true
			}
		]
	},
	"Success": true
}

错误码

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