使用DescribeRestoreRangeInfo查詢備份計劃的可恢復段詳情-Data Management-阿里雲 - Data Management

該介面用於查看一個備份計劃可恢復段詳情。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

dbs:DescribeRestoreRangeInfo

get

*BackupPlan

acs:dbs:{#regionId}:{#accountId}:backupplan/{#BackupPlanId}

無

請求參數

名稱	類型	必填	描述	樣本值
BackupPlanId	string	是	備份計劃 ID，可通過調用 DescribeBackupPlanList 介面擷取該參數的值。	dbssl67c7mx****
BeginTimestampForRestore	integer	是	查詢可恢複開始時間，可通過調用 DescribeBackupPlanList 介面擷取該參數的值。	1646674092000
EndTimestampForRestore	integer	是	查詢可恢複結束時間，可通過調用 DescribeBackupPlanList 介面擷取該參數的值。	1646846814000
ClientToken	string	否	用於保證請求的等冪性，防止重複提交請求。	ETnLKlblzczshOTUbOCzxxxxxxx
RecentlyRestore	boolean	否	是否開啟最近恢複。	true

返回參數

名稱	類型	描述	樣本值
	object	介面返回資訊如下。
HttpStatusCode	integer	HTTP 狀態代碼。	200
RequestId	string	請求 ID。	E2BD9DFC-6760-5F49-97C5-DA739E29****
ErrCode	string	錯誤碼。	Param.NotFound
Success	boolean	請求是否成功，傳回值如下： true：請求成功 false：請求失敗	true
ErrMessage	string	錯誤資訊。	The specified parameter %s value is not valid.
Items	object
DBSRecoverRange	array<object>	可恢復段資訊。
	array<object>	具體詳情記錄。
EndTimestampForRestore	integer	可恢複結束時間戳記。	1646760308000
SourceEndpointInstanceType	string	資料庫所在位置。（已淘汰，請參考 BackupSourceInstanceType）	rds
RangeType	string	可恢復段類型，傳回值如下： point：該時間段為全量備份離散時間點。 range：該時間段為連續備份時間段，可指定任意時間。	point
BeginTimestampForRestore	integer	可恢複開始時間戳。	1646760282000
SourceEndpointInstanceID	string	資料庫執行個體 ID。（已淘汰，請參考 BackupSourceInstanceId）	rm-bp106x9tk2c91****
FullBackupList	object
FullBackupDetail	array<object>	當 RangeType 為 point 時，該欄位展示這個時間段範圍內所有的權利。備份點資訊。
	object	具體詳情如下。
EndTime	integer	全量備份結束時間，傳回值：1646760308000。	1646760308000
StartTime	integer	全量備份開始時間，傳回值：1646760282000。	1646760282000
BackupSetId	string	備份組 ID。	qecnsxkd****
BackupSourceInstanceType	string	備份源執行個體類型	rds
BackupSourceInstanceId	string	備份源執行個體 Id	rm-testxx
BackupSourceHost	string	備份源串連地址	127.0.0.1
BackupSourcePort	string	備份源串連連接埠	3306

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "E2BD9DFC-6760-5F49-97C5-DA739E29****",
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "The specified parameter %s value is not valid. ",
  "Items": {
    "DBSRecoverRange": [
      {
        "EndTimestampForRestore": 1646760308000,
        "SourceEndpointInstanceType": "rds",
        "RangeType": "point",
        "BeginTimestampForRestore": 1646760282000,
        "SourceEndpointInstanceID": "rm-bp106x9tk2c91****",
        "FullBackupList": {
          "FullBackupDetail": [
            {
              "EndTime": 1646760308000,
              "StartTime": 1646760282000,
              "BackupSetId": "qecnsxkd****"
            }
          ]
        },
        "BackupSourceInstanceType": "rds",
        "BackupSourceInstanceId": "rm-testxx",
        "BackupSourceHost": "127.0.0.1",
        "BackupSourcePort": "3306"
      }
    ]
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
403	Request.Forbidden	Have no Permissions	當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作

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

變更歷史

更多資訊，參考變更詳情。