调用DescribeBackups获取集群备份列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeBackups |
系统规定参数。取值：DescribeBackups。 |
| BackupType | String | 是 | Incremental |
备份类型。取值：
|
| ClusterId | String | 是 | cds-uf6m0bod****6158 |
备份集群ID。 |
| DataCenterId | String | 是 | cn-shanghai-e |
备份集群数据中心ID。 |
返回数据
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| Backups | Array |
备份任务信息列表。 |
|
| Backup | |||
| BackupId | String | 20200*** |
备份ID。 |
| BackupType | String | Incremental |
备份类型。取值：
|
| ClusterId | String | cds-uf6m0bod****6159 |
备份集群ID。 |
| DataCenterId | String | cn-shanghai-e |
备份集群数据中心ID。 |
| EndTime | String | 2020-02-26T02:12:50Z |
备份结束时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 通用标准时，以Z来标识）。 |
| Size | Long | 149016650 |
备份大小。 |
| StartTime | String | 2020-02-26T01:57:00Z |
备份开始时间。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 通用标准时，以Z来标识）。 |
| Status | String | Succeeded |
备份状态。可取值部分示例：
|
| RequestId | String | A6E59F3B-5CB7-4922-85CA-06EC0BB00BAA |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeBackups
&BackupType=Incremental
&ClusterId=cds-uf6m0bod****6158
&DataCenterId=cn-shanghai-e
&<公共请求参数>正常返回示例
XML 格式
<DescribeBackupsResponse>
<RequestId>A6E59F3B-5CB7-4922-85CA-06EC0BB00BAA</RequestId>
<Backups>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-02-26T02:12:50Z</EndTime>
<ClusterId>cds-uf6m0bo****6159</ClusterId>
<Size>149016650</Size>
<StartTime>2020-02-26T01:57:00Z</StartTime>
<BackupId>20200226</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-02-27T01:01:28Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149494577</Size>
<StartTime>2020-02-27T01:01:00Z</StartTime>
<BackupId>20200227</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-02-28T01:01:23Z</EndTime>
<ClusterId>cds-uf6m0bo****v6159</ClusterId>
<Size>149282931</Size>
<StartTime>2020-02-28T01:01:00Z</StartTime>
<BackupId>20200228</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-02-29T01:00:56Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149454625</Size>
<StartTime>2020-02-29T00:25:28Z</StartTime>
<BackupId>20200229</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-02T22:12:41Z</EndTime>
<ClusterId>cds-uf6m0bo****v6159</ClusterId>
<Size>149364202</Size>
<StartTime>2020-03-01T00:30:00Z</StartTime>
<BackupId>20200301</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-02T00:30:13Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149356372</Size>
<StartTime>2020-03-02T00:30:00Z</StartTime>
<BackupId>20200302</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-04T02:11:59Z</EndTime>
<ClusterId>cds-uf6m0bo****v6159</ClusterId>
<Size>149359298</Size>
<StartTime>2020-03-03T00:30:00Z</StartTime>
<BackupId>20200303</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-04T02:12:09Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149267899</Size>
<StartTime>2020-03-04T00:30:00Z</StartTime>
<BackupId>20200304</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-06T15:52:58Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149188148</Size>
<StartTime>2020-03-05T00:30:00Z</StartTime>
<BackupId>20200305</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
<Backup>
<Status>Succeeded</Status>
<DataCenterId>cn-shanghai-e</DataCenterId>
<EndTime>2020-03-06T15:53:06Z</EndTime>
<ClusterId>cds-uf6m0bod****6159</ClusterId>
<Size>149188280</Size>
<StartTime>2020-03-06T00:30:00Z</StartTime>
<BackupId>20200306</BackupId>
<BackupType>Incremental</BackupType>
</Backup>
</Backups>
</DescribeBackupsResponse>JSON 格式
{
"RequestId": "A6E59F3B-5CB7-4922-85CA-06EC0BB00BAA",
"Backups": {
"Backup": [
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-02-26T02:12:50Z",
"ClusterId": "cds-uf6m0bo****6159",
"Size": 149016650,
"StartTime": "2020-02-26T01:57:00Z",
"BackupId": "20200226",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-02-27T01:01:28Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149494577,
"StartTime": "2020-02-27T01:01:00Z",
"BackupId": "20200227",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-02-28T01:01:23Z",
"ClusterId": "cds-uf6m0bo****v6159",
"Size": 149282931,
"StartTime": "2020-02-28T01:01:00Z",
"BackupId": "20200228",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-02-29T01:00:56Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149454625,
"StartTime": "2020-02-29T00:25:28Z",
"BackupId": "20200229",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-02T22:12:41Z",
"ClusterId": "cds-uf6m0bo****v6159",
"Size": 149364202,
"StartTime": "2020-03-01T00:30:00Z",
"BackupId": "20200301",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-02T00:30:13Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149356372,
"StartTime": "2020-03-02T00:30:00Z",
"BackupId": "20200302",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-04T02:11:59Z",
"ClusterId": "cds-uf6m0bo****v6159",
"Size": 149359298,
"StartTime": "2020-03-03T00:30:00Z",
"BackupId": "20200303",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-04T02:12:09Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149267899,
"StartTime": "2020-03-04T00:30:00Z",
"BackupId": "20200304",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-06T15:52:58Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149188148,
"StartTime": "2020-03-05T00:30:00Z",
"BackupId": "20200305",
"BackupType": "Incremental"
},
{
"Status": "Succeeded",
"DataCenterId": "cn-shanghai-e",
"EndTime": "2020-03-06T15:53:06Z",
"ClusterId": "cds-uf6m0bod****6159",
"Size": 149188280,
"StartTime": "2020-03-06T00:30:00Z",
"BackupId": "20200306",
"BackupType": "Incremental"
}
]
}
}错误码
访问错误中心查看更多错误码。