全部產品
Search

搜尋本產品

    Security Center：DescribeRestoreJobs - 查詢防勒索恢複任務的詳情

    文件中心

    Security Center：DescribeRestoreJobs - 查詢防勒索恢複任務的詳情

    更新時間：Mar 21, 2026

    查詢防勒索恢複任務（即資料備份）的詳情。

    介面說明

    如果您的伺服器資料已被勒索破壞入侵，Security Center通過執行恢複任務，使用備份資料來恢複當前伺服器的資料。

    說明

    您啟用防勒索防護策略時，防勒索功能會備份您的伺服器資料。關於防勒索防護策略的介紹，請參見管理防護策略。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    yundun-sas:DescribeRestoreJobs

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Status

    string

    否

    恢複狀態。 取值：

    • RUNNING：恢複任務執行中

    • COMPLETE：恢複任務已完成

    • FAILED：恢複任務執行失敗

    • CANCELING：恢複任務取消中

    • CANCELED：恢複任務已取消

    • PARTIAL_COMPLETE：恢複任務部分成功

    • CREATED：恢複任務已建立，但尚未開始啟動

    • EXPIRED：恢複任務未更新

    • QUEUED：恢複任務在等待啟動中

    • CLIENT_DELETED：防勒索用戶端已被刪除，任務執行失敗

    RUNNING
    MachineRemark

    string

    否

    執行防勒索恢複任務的伺服器的標識符，例如：伺服器 IP 位址或伺服器名稱。

    1.1.XX.XX
    PageSize

    integer

    是

    設定分頁查詢時，每頁顯示的恢複任務的數量。預設值為 10，表示每頁顯示 10 條恢複任務。

    10
    CurrentPage

    integer

    是

    設定從返回結果的第幾頁開始顯示查詢結果。預設值為 1，表示從第 1 頁開始顯示。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

    0ED92280-4363-57D3-A4D3-4D3FBC99B29F
    PageInfo

    object

    頁面上顯示的查詢結果資訊。

    CurrentPage

    integer

    分頁查詢時，當前頁的頁碼。

    1
    PageSize

    integer

    分頁查詢時，每頁顯示的恢複任務的數量。預設值為 10，表示每頁顯示 10 條恢複任務。

    10
    TotalCount

    integer

    查詢到的恢複任務的總數量。

    69
    Count

    integer

    查詢到的當前結果頁面中恢複任務的條數。

    2
    RestoreJobs

    array<object>

    恢複任務的詳細資料。

    object

    Status

    string

    資料備份的狀態。 取值：

    • RUNNING：恢複任務執行中

    • COMPLETE：恢複任務已完成

    • FAILED：恢複任務執行失敗

    • CANCELING：恢複任務取消中

    • CANCELED：恢複任務已取消

    • PARTIAL_COMPLETE：恢複任務部分成功

    • CREATED：恢複任務已建立，但尚未開始啟動

    • EXPIRED：恢複任務未更新

    • QUEUED：恢複任務在等待啟動中

    • CLIENT_DELETED：防勒索用戶端已被刪除，任務執行失敗

    COMPLETE
    SnapshotHash

    string

    備份伺服器資料時，儲存備份資料的快照 Hash 值。

    a3992de83f529b844135fe795d949181735a7d20e0ac8539485c61b7983e618f
    SourceClientId

    string

    產生備份資料的防勒索用戶端的 ID。

    c-000gmcypy5dyf9ey3uv7
    ErrorFileUrl

    string

    恢複任務失敗的 CSV 檔案下載的 URL。

    ["/home/user"]
    Includes

    string

    恢複檔案原所在的目錄。該目錄是在建立防勒索防護策略時指定的，即需要防護的目錄。

    ["/root/disk-uuid-test","/root/install.sh"]
    RestoreName

    string

    恢複任務的名稱。

    Restore
    InternetIp

    string

    恢複資料的伺服器的公網 IP 位址。

    1.1.XX.XX
    VaultId

    string

    備份資料存入的倉庫的 ID。

    v-000b0v0jqzmse2yz06zw
    ActualBytes

    integer

    備份檔案的大小，單位為 Bytes。

    20
    Message

    string

    錯誤碼訊息。

    successful
    Percentage

    integer

    恢複任務的進度百分比。

    100
    GmtModified

    string

    恢複任務更新的時間。

    2021-04-25T19:11Z
    RestoreType

    string

    恢複檔案的類型。取值：

    • ECS_FILE：來自Elastic Compute Service 的檔案

    • FILE：來自本地主機檔案

    ECS_FILE
    ExitCode

    string

    恢複任務的傳回值。

    0
    ClientId

    string

    恢複任務用戶端的 ID。

    c-000frxwusjauhp9ajpu6
    ItemsDone

    integer

    成功恢複的檔案的數量。

    0
    BytesTotal

    integer

    需要恢複的資料總量，單位為 Bytes。

    20
    RequestId

    string

    本次調用請求的 ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

    0ED92280-4363-57D3-A4D3-4D3FBC99B29F
    InstanceName

    string

    需要恢複資料的伺服器的名稱。

    win2012-01
    CompleteTime

    integer

    恢複任務的完成時間戳記，單位為毫秒。

    1583289054000
    ErrorType

    string

    恢複任務的錯誤碼。

    NONE
    SnapshotVersion

    string

    伺服器資料的恢複版本（即備份版本）。

    2020-03-03 18:00
    Target

    string

    備份資料存放區的目標檔案夾。建立恢複任務後，備份資料會恢複至該檔案夾中。

    /home
    CreatedTime

    integer

    恢複任務的建立時間戳記，單位為毫秒。

    1583289052000
    InstanceId

    string

    需要恢複資料的伺服器的執行個體 ID。

    i-bp12xnvdax6307gw****
    Source

    string

    恢複內容。

    ["/home/admin","\\\\servername\\sharename"]
    IntranetIp

    string

    需要恢複資料的伺服器的內網 IP 位址。

    2.1.XX.XX
    ErrorFile

    string

    恢複失敗的檔案清單的 CSV 檔案名稱。

    s-000f4wxm8f7gur6g2otm.csv
    Uuid

    string

    需要恢複備份資料的伺服器的 UUID。

    6E3DABB6-3F6A-40DB-9492-2C8B59C****
    Excludes

    string

    恢複檔案中所排除的目錄。該目錄是在建立防勒索防護策略時指定的，即無需防護的目錄。

    ["/home/user"]
    Speed

    integer

    資料恢複的速度，單位為 Byte/s。

    25766558
    SnapshotId

    string

    備份伺服器資料時，儲存備份資料的快照 Hash 值 ID。

    s-000gmcypy5dy54e39yny
    UpdatedTime

    integer

    備份任務最後更新的時間戳記，單位為毫秒。

    1583289054000
    RestoreId

    string

    恢複任務的 ID。

    r-000gmcypy5dyf9ey3uv7
    GmtCreate

    string

    恢複任務建立的時間。

    2021-04-25T19:11Z
    Eta

    integer

    進行中的恢複任務的預計完成時間戳記，單位為秒。

    1583299054
    Duration

    integer

    恢複任務的期間，單位為秒。

    100
    ErrorCount

    integer

    報錯的恢複任務的數量。

    0
    ItemsTotal

    integer

    需要恢複的檔案的總數量。

    0
    BytesDone

    integer

    成功恢複的資料總量，單位為 Bytes。

    20
    VaultRegionId

    string

    備份倉庫所屬的地區 ID。

    cn-hangzhou

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "0ED92280-4363-57D3-A4D3-4D3FBC99B29F",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 10,
    "TotalCount": 69,
    "Count": 2
  },
  "RestoreJobs": [
    {
      "Status": "COMPLETE",
      "SnapshotHash": "a3992de83f529b844135fe795d949181735a7d20e0ac8539485c61b7983e618f",
      "SourceClientId": "c-000gmcypy5dyf9ey3uv7",
      "ErrorFileUrl": "[\"/home/user\"]",
      "Includes": "[\"/root/disk-uuid-test\",\"/root/install.sh\"]",
      "RestoreName": "Restore",
      "InternetIp": "1.1.XX.XX",
      "VaultId": "v-000b0v0jqzmse2yz06zw",
      "ActualBytes": 20,
      "Message": "successful",
      "Percentage": 100,
      "GmtModified": "2021-04-25T19:11Z",
      "RestoreType": "ECS_FILE",
      "ExitCode": "0",
      "ClientId": "c-000frxwusjauhp9ajpu6",
      "ItemsDone": 0,
      "BytesTotal": 20,
      "RequestId": "0ED92280-4363-57D3-A4D3-4D3FBC99B29F",
      "InstanceName": "win2012-01",
      "CompleteTime": 1583289054000,
      "ErrorType": "NONE",
      "SnapshotVersion": "2020-03-03 18:00",
      "Target": "/home",
      "CreatedTime": 1583289052000,
      "InstanceId": "i-bp12xnvdax6307gw****",
      "Source": "[\"/home/admin\",\"\\\\\\\\servername\\\\sharename\"]",
      "IntranetIp": "2.1.XX.XX",
      "ErrorFile": "s-000f4wxm8f7gur6g2otm.csv",
      "Uuid": "6E3DABB6-3F6A-40DB-9492-2C8B59C****",
      "Excludes": "[\"/home/user\"]",
      "Speed": 25766558,
      "SnapshotId": "s-000gmcypy5dy54e39yny",
      "UpdatedTime": 1583289054000,
      "RestoreId": "r-000gmcypy5dyf9ey3uv7",
      "GmtCreate": "2021-04-25T19:11Z",
      "Eta": 1583299054,
      "Duration": 100,
      "ErrorCount": 0,
      "ItemsTotal": 0,
      "BytesDone": 20,
      "VaultRegionId": "cn-hangzhou"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    500 ServerError ServerError 服務故障，請稍後重試！
    403 NoPermission caller has no permission 當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作。

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

    變更歷史

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