調用DescribeBackup獲取備份概要信息。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeBackup

系統規定參數。取值：DescribeBackup。
BackupId String 是 2020010121****

備份ID。
BackupType String 是 Incremental

備份類型。取值：

  • full：全量備份
  • Incremental：增量備份
ClusterId String 是 cds-bp11tjzh50****78

備份集群ID。
DataCenterId String 是 cn-hangzhou-g

備份集群數據中心ID。

返回數據

名稱 類型 示例值 描述
Backup Struct

備份計劃概要信息列表。
BackupId String 2020010121****

備份ID。
BackupType String Incremental

備份類型。取值：

  • full：全量備份
  • Incremental：增量備份
ClusterId String cds-bp11tjzh50****7v

備份集群ID。
DataCenterId String cn-hangzhou-g

備份集群數據中心ID。
Details String {"name": "cds-uf6m0bod****6159-20200226", "start": "2020-02-26 01:57:05", "end": "2020-02-26 02:12:50", "completeNodes": ["cds-uf6m0bod4****159-1-core-002.cassandra.rds.aliyuncs.com", "cds-uf6m0bo****v6159-1-core-001.cassandra.rds.aliyuncs.com", "cds-uf6m0bod****6159-1-core-003.cassandra.rds.aliyuncs.com"], "incompleteNodes": [], "missingNodes": [], "files": 923, "size": 149016650}

備份細節。
EndTime String 2020-01-01 21:48:54Z

備份結束時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 通用標準時，以Z來標識）。
Size Long 149016650

備份大小。
StartTime String 2020-01-01 21:48:40Z

備份開始時間。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 通用標準時，以Z來標識）。
Status String Succeeded

備份狀態。可取值部分示例：

  • Succeeded：成功
  • Failed：失敗
RequestId String 200FB963-9359-4CAD-90B7-96395C88FD9D

請求ID。

示例

請求示例

http(s)://[Endpoint]/?Action=DescribeBackup
&BackupId=2020010121****
&BackupType=Incremental
&ClusterId=cds-bp11tjzh50****78
&DataCenterId= cn-hangzhou-g
&<公共請求參數>

正常返回示例

XML 格式 

<DescribeBackupResponse>
      <RequestId>FA04A743-6C3F-4C06-A2B7-6B75B9D3D18C</RequestId>
      <Backup>
            <Status>Succeeded</Status>
            <DataCenterId>cn-shanghai-e</DataCenterId>
            <Details>{"name": "cds-uf6m0bod****6159-20200226", "start": "2020-02-26 01:57:05", "end": "2020-02-26 02:12:50", "completeNodes": ["cds-uf6m0bod****6159-1-core-002.cassandra.rds.aliyuncs.com", "cds-uf6m0bod****6159-1-core-001.cassandra.rds.aliyuncs.com", "cds-uf6m0bod****6159-1-core-003.cassandra.rds.aliyuncs.com"], "incompleteNodes": [], "missingNodes": [], "files": 923, "size": 149016650}
    </Details>
            <EndTime>2020-02-26T02:12:50Z</EndTime>
            <ClusterId>cds-uf6m0bo****v6159</ClusterId>
            <Size>149016650</Size>
            <StartTime>2020-02-26T01:57:00Z</StartTime>
            <BackupId>20200226</BackupId>
            <BackupType>Incremental</BackupType>
      </Backup>
</DescribeBackupResponse>

JSON 格式 

{
  "RequestId": "FA04A743-6C3F-4C06-A2B7-6B75B9D3D18C",
  "Backup": {
    "Status": "Succeeded",
    "DataCenterId": "cn-shanghai-e",
    "Details": "{\"name\": \"cds-uf6m0bod****6159-20200226\", \"start\": \"2020-02-26 01:57:05\", \"end\": \"2020-02-26 02:12:50\", \"completeNodes\": [\"cds-uf6m0bod****6159-1-core-002.cassandra.rds.aliyuncs.com\", \"cds-uf6m0bod****6159-1-core-001.cassandra.rds.aliyuncs.com\", \"cds-uf6m0bod****6159-1-core-003.cassandra.rds.aliyuncs.com\"], \"incompleteNodes\": [], \"missingNodes\": [], \"files\": 923, \"size\": 149016650}\n",
    "EndTime": "2020-02-26T02:12:50Z",
    "ClusterId": "cds-uf6m0bo****v6159",
    "Size": 149016650,
    "StartTime": "2020-02-26T01:57:00Z",
    "BackupId": "20200226",
    "BackupType": "Incremental"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。