调用DescribeBackupFiles接口查询可恢复的备份文件。

调试

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

请求参数

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

要执行的操作。取值:DescribeBackupFiles

Uuid String 6d5b361f-958d-48a8-a9d2-d6e82c1a****

防勒索策略防护服务器的UUID。

Path String “”

备份策略文件的路径。

SnapshotHash String a7f26223ef3974c6fac324cd37713ab65ab618859d20b4039192a5da44d77b63

备份文件版本的HASH值。

CurrentPage String 1

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

PageSize String 10

设置分页查询时,每页显示的备份文件的数量。默认值为10,表示每页显示10条备份文件。

返回数据

名称 类型 示例值 描述
RequestId String 00A60A6D-33E0-5D5A-9B7C-E5D4DCA88148

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

PageInfo Object

页面显示的信息。

CurrentPage Integer 1

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

PageSize Integer 10

分页查询时,每页显示的备份文件的数量。默认值为10,表示每页显示10条备份文件。

TotalCount Integer 69

备份文件的总数量。

Count Integer 10

当前页面显示的备份文件的数量。

BackupFiles Array of BrowseFile

防勒索备份数据的信息。

Type String dir

防护文件的类型。取值:

  • file:表示文件。
  • dir:表示文件夹。
Name String Group 1

策略名称。

Subtree String Python27\

备份文件子目录的路径。

Size Long 100

备份文件的大小,单位为Byte。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeBackupFiles
&Uuid=6d5b361f-958d-48a8-a9d2-d6e82c1a****
&Path=“”
&SnapshotHash=a7f26223ef3974c6fac324cd37713ab65ab618859d20b4039192a5da44d77b63
&CurrentPage=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

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

<DescribeBackupFilesResponse>
    <RequestId>00A60A6D-33E0-5D5A-9B7C-E5D4DCA88148</RequestId>
    <PageInfo>
        <CurrentPage>1</CurrentPage>
        <PageSize>10</PageSize>
        <TotalCount>69</TotalCount>
        <Count>10</Count>
    </PageInfo>
    <BackupFiles>
        <Type>dir</Type>
        <Name>Group 1</Name>
        <Subtree>Python27\</Subtree>
        <Size>100</Size>
    </BackupFiles>
</DescribeBackupFilesResponse>

JSON格式

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

{
  "RequestId" : "00A60A6D-33E0-5D5A-9B7C-E5D4DCA88148",
  "PageInfo" : {
    "CurrentPage" : 1,
    "PageSize" : 10,
    "TotalCount" : 69,
    "Count" : 10
  },
  "BackupFiles" : [ {
    "Type" : "dir",
    "Name" : "Group 1",
    "Subtree" : "Python27\\",
    "Size" : 100
  } ]
}

错误码

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