全部產品
Search

搜尋本產品

    Cloud Backup：DescribeHanaRestores - 查詢合格SAP HANA恢複任務

    文件中心

    Cloud Backup：DescribeHanaRestores - 查詢合格SAP HANA恢複任務

    更新時間：Dec 23, 2025

    查詢合格SAP HANA恢複任務。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    hbr:DescribeHanaRestores

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    VaultId

    string

    否

    備份倉庫 ID。

    v-000au6bq******mpu
    ClusterId

    string

    是

    SAP HANA 執行個體 ID。

    cl-000b******soejg
    PageNumber

    integer

    否

    分頁頁碼。從 1 開始，預設值為 1。

    1
    PageSize

    integer

    否

    分頁大小。最小值為 1，最大值為 99，預設值為 10。

    10
    RestoreId

    string

    否

    恢複任務 ID。

    r-0007o3vqfukfe92hvf13
    DatabaseName

    string

    否

    資料庫名稱。

    SYSTEMDB
    BackupId

    integer

    否

    備份 ID。

    1632754800158
    RestoreStatus

    string

    否

    恢複任務狀態。

    • RUNNING：運行中

    • COMPLETE：成功

    • PARTIAL_COMPLETE：部分成功

    • FAILED：失敗

    • CANCELED：已取消

    • EXPIRED：已逾時

    COMPLETE
    ResourceGroupId

    string

    否

    資源群組 ID。

    rg-acfm4ebtpkzx7zy

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    7DEFC897-8F05-5C05-912C-C9A9510FBFF1
    Success

    boolean

    請求是否成功。

    • true：成功

    • false：失敗

    true
    Code

    string

    返回碼，200 表示成功。

    200
    Message

    string

    返回資訊描述，成功一般返回 successful，錯誤時會返回相應錯誤資訊。

    successful
    PageNumber

    integer

    分頁頁碼。從 1 開始，預設值為 1。

    1
    PageSize

    integer

    分頁大小。最小值為 1，最大值為 99，預設值為 10。

    10
    TotalCount

    integer

    總記錄數。

    19
    HanaRestore

    object

    HanaRestores

    array<object>

    恢複工作清單。

    object

    恢複任務。

    Status

    string

    恢複任務狀態。

    • RUNNING：運行中

    • COMPLETE：成功

    • PARTIAL_COMPLETE：部分成功

    • FAILED：失敗

    • CANCELED：已取消

    • EXPIRED：已逾時

    COMPLETE
    ReachedTime

    integer

    恢複的實際時間點。

    1635315505
    VaultId

    string

    備份倉庫 ID。

    v-000g9acf******gta
    CurrentPhase

    integer

    當前恢複階段，該值直接從 SAP HANA 擷取。

    2
    ClearLog

    boolean

    恢複後，日誌條目將從日誌區中刪除。初始化日誌地區，如果不想恢複駐留在日誌區中的日誌段，請選擇 true，否則選擇 false。

    true
    Message

    string

    恢複階段詳情。

    SQL Error 448 - recovery could not be completed:
    CheckAccess

    boolean

    檢查差異和記錄備份可用性。

    • true：在恢複開始時，系統會檢查所需的差異備份和記錄備份是否都可用。 如果缺少差異備份或記錄備份，在更改資料之前會停止恢複。

    • false：不開啟檢查。

    true
    Mode

    string

    恢複方式。

    • RECOVERY_TO_MOST_RECENT： 將資料庫恢複到已備份的最近可用狀態。

    • RECOVERY_TO_POINT_IN_TIME：將資料庫恢複到特定時間點。

    • RECOVERY_TO_SPECIFIC_BACKUP：將資料庫恢複到指定的Database Backup。

    • RECOVERY_TO_LOG_POSITION：將資料庫還原到指定日誌位置。

    RECOVERY_TO_SPECIFIC_BACKUP
    SystemCopy

    boolean

    是否是跨執行個體恢複。

    • true：跨執行個體恢複

    • false：非跨執行個體恢複

    true
    CurrentProgress

    integer

    當前進度，該值直接從 SAP HANA 擷取。

    1
    UseDelta

    boolean

    是否使用差異備份。如果您需要使用差異備份或增量備份執行恢複，請選擇 true。如果選擇在不使用差異備份或增量備份的情況下執行恢複，則使用記錄備份進行恢複。

    true
    BackupID

    integer

    備份 ID。

    1635315505
    SourceClusterId

    string

    源 SAP HANA 執行個體 ID。

    cl-0000g3mvy******5cj
    VolumeId

    integer

    要恢複的 Volume ID。僅選擇RECOVERY_TO_LOG_POSITION恢複方式時有效。

    0
    DatabaseName

    string

    資料庫的名稱。

    BWD
    Phase

    string

    恢複階段。

    restart
    ClusterId

    string

    待恢複的 SAP HANA 執行個體 ID。

    cl-000923yu******p00j4
    DatabaseRestoreId

    integer

    資料庫恢複 ID。

    1644038961030
    State

    string

    狀態，該值直接從 SAP HANA 擷取。

    successful
    Source

    string

    源系統名。表示需要恢複的來源資料庫名，格式為來源資料庫名@SID。

    PRD@H4P
    MaxPhase

    integer

    最大階段，該值直接從 SAP HANA 擷取。

    4
    EndTime

    integer

    恢複任務結束時間。UNIX 時間，單位為秒。

    1634356382
    StartTime

    integer

    恢複任務開始時間。UNIX 時間，單位為秒。

    1636970413
    BackupPrefix

    string

    備份首碼。

    INC_DATA_BACKUP
    RestoreId

    string

    恢複任務 ID。

    r-000c1en183ayn9sesgqh
    LogPosition

    integer

    日誌位置，僅選擇RECOVERY_TO_LOG_POSITION恢複方式時有效。

    0
    RecoveryPointInTime

    integer

    選擇需要恢複到的時間點。僅選擇RECOVERY_TO_POINT_IN_TIME恢複方式時有效，系統會將資料庫恢複到離這個時間最近的狀態。

    1649851200
    MaxProgress

    integer

    最大進度，該值直接從 SAP HANA 擷取。

    1
    UseCatalog

    boolean

    是否從 Catalog 中尋找備份。僅選擇RECOVERY_TO_SPECIFIC_BACKUP恢複方式時有效。如果不使用 Catalog，需要指定一個備份首碼，雲備份服務會根據備份首碼進行恢複。

    false

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "7DEFC897-8F05-5C05-912C-C9A9510FBFF1",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 19,
  "HanaRestore": {
    "HanaRestores": [
      {
        "Status": "COMPLETE",
        "ReachedTime": 1635315505,
        "VaultId": "v-000g9acf******gta",
        "CurrentPhase": 2,
        "ClearLog": true,
        "Message": "SQL Error 448 - recovery could not be completed:",
        "CheckAccess": true,
        "Mode": "RECOVERY_TO_SPECIFIC_BACKUP",
        "SystemCopy": true,
        "CurrentProgress": 1,
        "UseDelta": true,
        "BackupID": 1635315505,
        "SourceClusterId": "cl-0000g3mvy******5cj",
        "VolumeId": 0,
        "DatabaseName": "BWD",
        "Phase": "restart",
        "ClusterId": "cl-000923yu******p00j4",
        "DatabaseRestoreId": 1644038961030,
        "State": "successful",
        "Source": "PRD@H4P",
        "MaxPhase": 4,
        "EndTime": 1634356382,
        "StartTime": 1636970413,
        "BackupPrefix": "INC_DATA_BACKUP",
        "RestoreId": "r-000c1en183ayn9sesgqh",
        "LogPosition": 0,
        "RecoveryPointInTime": 1649851200,
        "MaxProgress": 1,
        "UseCatalog": false
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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