首页 云备份 开发参考 API参考 API目录 其他 BrowseFiles - 浏览备份文件列表

BrowseFiles - 浏览备份文件列表

更新时间: 2026-03-19 14:31:51

浏览备份文件列表

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

Token

string

已弃用,勿填。

***

VaultId

string

备份仓库 ID。

v-000***jtz

ClientId

string

备份客户端 ID。

c-000***o48

SnapshotHash

string

备份点的哈希值。

971***e9d

Path

string

目录的哈希值,不指定表示浏览备份的根目录。

ef6***46a

AbsolutePath

string

目录的路径,浏览备份根目录时使用 / 。

/data/

PageNumber

integer

已废弃,建议改用 MaxResults 和 NextToken 参数实现翻页。

1

PageSize

integer

已废弃,建议改用 MaxResults 和 NextToken 参数实现翻页。

10

RestoreId

string

已废弃

r-000***oy9

NextToken

string

获取下一页结果所需的 Token。

eyJ***Q==

MaxResults

integer

每次查询结果的个数。

取值范围:10~100。默认值:10。

10

StorageClass

string

备份数据存储类型。取值:

  • STANDARD:标准。

  • ARCHIVE:归档。

STANDARD

Edition

string

云备份功能版本,支持:

  • STANDARD: 标准版,默认值。

  • BASIC:基础版。目前仅支持 ECS 文件备份基础版。

枚举值:

  • STANDARD :

    标准版

  • BASIC :

    ECS 文件备份基础版

STANDARD

返回参数

名称

类型

描述

示例值

object

NextToken

string

下一页开始的 Token,NextToken 为空说明没有下一页。

eyJ***Q==

RequestId

string

请求 ID。

843F7A45-8B***35-ECECBE5E5F78

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

记录总数

11

MaxResults

integer

本次读取的最大数据记录数量。

10

Nodes

object

Node

array<object>

文件系统对象

object

文件系统对象属性

Type

string

对象类型

枚举值:

  • file :

    文件

  • symlink :

    符合链接

  • dir :

    目录

file

Name

string

文件或目录名

fileName

Subtree

string

子目录的哈希值

ef6***46a

Size

integer

文件大小。

58727654

示例

正常返回示例

JSON格式

{
  "NextToken": "eyJ***Q==\n",
  "RequestId": "843F7A45-8B***35-ECECBE5E5F78",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 11,
  "MaxResults": 10,
  "Nodes": {
    "Node": [
      {
        "Type": "file",
        "Name": "fileName",
        "Subtree": "ef6***46a",
        "Size": 58727654
      }
    ]
  }
}

错误码

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

变更历史

更多信息,参考变更详情

上一篇: AddCrossAccount - 添加跨账号纳管关系 下一篇: CreateVaultReplication - 配置备份库复制
阿里云首页 云备份 相关技术圈