全部產品
Search
文件中心

Cloud Backup:BrowseFiles - 瀏覽備份檔案列表

更新時間:Mar 19, 2026

瀏覽備份檔案列表

調試

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

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

Token

string

已棄用,勿填。

***

VaultId

string

備份倉庫 ID。

v-000***jtz

ClientId

string

備份用戶端識別碼。

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
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情