调用DescribeRestoreJobs接口查询防勒索恢复任务(即数据恢复结果)的详情。

如果您的服务器数据已被勒索病毒入侵,云安全中心通过执行恢复任务,使用备份数据来恢复当前服务器的数据。

说明 您启用防勒索防护策略时,防勒索功能会备份您的服务器数据。关于防勒索防护策略的介绍,请参见管理防护策略

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRestoreJobs

要执行的操作。取值:DescribeRestoreJobs

Status String RUNNING

数据备份的状态。 取值:

  • RUNNING:恢复任务执行中
  • COMPLETE:恢复任务已完成
  • FAILED:恢复任务执行失败
  • CANCELING:恢复任务取消中
  • CANCELED:恢复任务已取消
  • PARTIAL_COMPLETE:恢复任务部分成功
  • CREATED:恢复任务已创建,但尚未开始启动
  • EXPIRED:恢复任务未更新
  • QUEUED:恢复任务在等待启动中
  • CLIENT_DELETED:防勒索客户端已被删除,任务执行失败
MachineRemark String 1.1.XX.XX

执行防勒索恢复任务的服务器的标识符,例如:服务器IP地址或服务器名称。

PageSize Integer 10

设置分页查询时,每页显示的恢复任务的数量。默认值为10,表示每页显示10条恢复任务。

CurrentPage Integer 1

设置从返回结果的第几页开始显示查询结果。默认值为1,表示从第1页开始显示。

返回数据

名称 类型 示例值 描述
RequestId String 0ED92280-4363-57D3-A4D3-4D3FBC99B29F

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

PageInfo Object

页面上显示的查询结果信息。

CurrentPage Integer 1

分页查询时,当前页的页码。

PageSize Integer 10

分页查询时,每页显示的恢复任务的数量。默认值为10,表示每页显示10条恢复任务。

TotalCount Integer 69

查询到的恢复任务的总数量。

Count Integer 2

查询到的当前结果页面中恢复任务的条数。

RestoreJobs Array of RestoreJob

恢复任务的详细信息。

Status String COMPLETE

数据备份的状态。 取值:

  • RUNNING:恢复任务执行中
  • COMPLETE:恢复任务已完成
  • FAILED:恢复任务执行失败
  • CANCELING:恢复任务取消中
  • CANCELED:恢复任务已取消
  • PARTIAL_COMPLETE:恢复任务部分成功
  • CREATED:恢复任务已创建,但尚未开始启动
  • EXPIRED:恢复任务未更新
  • QUEUED:恢复任务在等待启动中
  • CLIENT_DELETED:防勒索客户端已被删除,任务执行失败
SnapshotHash String a3992de83f529b844135fe795d949181735a7d20e0ac8539485c61b7983e618f

备份服务器数据时,存储备份数据的快照Hash值。

SourceClientId String c-000gmcypy5dyf9ey3uv7

生成备份数据的防勒索客户端的ID。

ErrorFileUrl String ["/home/user"]

恢复任务失败的CSV文件下载的URL。

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

恢复文件中所包含的目录。该目录是在创建防勒索防护策略时指定的,即需要防护的目录。

RestoreName String Restore

恢复任务的名称。

InternetIp String 1.1.XX.XX

恢复数据的服务器的公网IP地址。

VaultId String v-000b0v0jqzmse2yz06zw

备份数据存入的仓库的ID。

ActualBytes Long 20

恢复的数据的大小,单位为Bytes。

Message String successful

错误码消息。

Percentage Integer 100

恢复任务的进度百分比。

GmtModified String 2021-04-25T19:11Z

恢复任务更新的时间。

RestoreType String ECS_FILE

恢复文件的类型。取值:

  • ECS_FILE:来自云服务器ECS的文件
  • FILE:来自本地主机文件
ExitCode String 0

恢复任务的返回值。

ClientId String c-000frxwusjauhp9ajpu6

防勒索客户端的ID。

ItemsDone Long 0

成功备份的文件的数量。

BytesTotal Long 20

需要恢复的数据总量,单位为Bytes。

RequestId String 0ED92280-4363-57D3-A4D3-4D3FBC99B29F

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

InstanceName String win2012-01

需要恢复数据的服务器的名称。

CompleteTime Long 1583289054000

恢复任务的完成时间戳,单位为毫秒。

ErrorType String NONE

恢复任务的错误码。

SnapshotVersion String 2020-03-03 18:00

服务器数据的恢复版本(即备份版本)。

Target String /home

备份数据存储的目标文件夹。创建恢复任务后,备份数据会恢复至该文件夹中。

CreatedTime Long 1583289052000

恢复任务的创建时间戳,单位为毫秒。

InstanceId String i-bp12xnvdax6307gw****

需要恢复数据的服务器的实例ID。

Source String ["/home/admin","\\\\servername\\sharename"]

备份的数据源文件所在的目录。

IntranetIp String 2.1.XX.XX

需要恢复数据的服务器的内网IP地址。

ErrorFile String s-000f4wxm8f7gur6g2otm.csv

恢复失败的文件列表的CSV文件名称。

Uuid String 6E3DABB6-3F6A-40DB-9492-2C8B59C****

需要恢复备份数据的服务器的UUID。

Excludes String ["/home/user"]

恢复文件中所排除的目录。该目录是在创建防勒索防护策略时指定的,即无需防护的目录。

Speed Long 25766558

数据备份的速度,单位为Byte/s。

SnapshotId String s-000gmcypy5dy54e39yny

备份服务器数据时,存储备份数据的快照Hash值ID。

UpdatedTime Long 1583289054000

备份任务最后更新的时间戳,单位为毫秒。

RestoreId String r-000gmcypy5dyf9ey3uv7

恢复任务的ID。

GmtCreate String 2021-04-25T19:11Z

恢复任务创建的时间。

Eta Long 1583299054

进行中的恢复任务的预计完成时间戳,单位为秒。

Duration Long 100

恢复任务的持续时间,单位为秒。

ErrorCount Long 0

报错的恢复任务的数量。

ItemsTotal Long 0

需要备份的文件的总数量。

BytesDone Long 20

成功恢复的数据总量,单位为Bytes。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeRestoreJobs
&Status=RUNNING
&MachineRemark=1.1.XX.XX
&PageSize=10
&CurrentPage=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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
  } ]
}

错误码

访问错误中心查看更多错误码。