全部產品
Search

搜尋本產品

    File Storage NAS：ListLifecycleRetrieveJobs - 查詢資料取回工作清單

    文件中心

    File Storage NAS：ListLifecycleRetrieveJobs - 查詢資料取回工作清單

    更新時間：Apr 04, 2026

    擷取已建立的資料取回工作清單。

    介面說明

    僅通用型 NAS 檔案系統支援該功能。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    nas:ListLifecycleRetrieveJobs

    get

    *FileSystem

    acs:nas:{#regionId}:{#accountId}:filesystem/{#FileSystemId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    PageSize

    integer

    否

    每個分頁包含的資料取回任務個數。

    取值範圍：1~100

    預設值：10

    10
    PageNumber

    integer

    否

    列表的分頁頁碼。

    起始值（預設值）：1

    1
    FileSystemId

    string

    否

    檔案系統 ID。

    31a8e4****
    Status

    string

    否

    資料取回任務的狀態。取值：

    • active：運行中。

    • canceled ：已取消。

    • completed：已完成。

    • failed：已失敗。

    completed
    StorageType

    string

    否

    分級儲存類型。

    • InfrequentAccess：低頻儲存。

    • Archive：Archive Storage。

    說明

    如未指定 StorageType，則返回所有類型的資料取回任務資訊。

    InfrequentAccess

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalCount

    integer

    資料取回任務總數。

    10
    RequestId

    string

    請求 ID。

    BC7C825C-5F65-4B56-BEF6-98C56C7C****
    PageSize

    integer

    每個分頁包含的資料取回任務個數。

    10
    PageNumber

    integer

    列表的分頁頁碼。

    1
    LifecycleRetrieveJobs

    array<object>

    資料取回任務資訊集合。

    object

    資料取回任務資訊集合。

    FileSystemId

    string

    檔案系統 ID。

    31a8e4****
    Status

    string

    資料取回任務的狀態。包括：

    • active：運行中。

    • canceled ：已取消。

    • completed：已完成。

    • failed：已失敗。

    completed
    DiscoveredFileCount

    integer

    執行資料取回任務讀取檔案的總個數。

    100
    UpdateTime

    string

    任務更新時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    2021-02-30T11:08:08Z
    Paths

    array

    指定取回任務的執行路徑。

    string

    指定取回的目錄或檔案。

    必須以正斜線（/）開頭，並且是掛載點中真實存在的路徑。

    ["/pathway/to/folder","/pathway/to/folder","/pathway/to/folder"]
    RetrievedFileCount

    integer

    執行資料取回任務成功取回的檔案個數。

    80
    JobId

    string

    資料取回任務 ID。

    lrj-nfstest-ia-160****853-hshvw
    CreateTime

    string

    任務建立時間。

    執行 ISO8601 標準表示，返回格式：yyyy-MM-ddTHH:mm:ssZ。

    2021-02-30T10:08:08Z
    StorageType

    string

    分級儲存類型。

    • InfrequentAccess：低頻儲存。

    • Archive：Archive Storage。

    InfrequentAccess

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": 10,
  "RequestId": "BC7C825C-5F65-4B56-BEF6-98C56C7C****",
  "PageSize": 10,
  "PageNumber": 1,
  "LifecycleRetrieveJobs": [
    {
      "FileSystemId": "31a8e4****",
      "Status": "completed",
      "DiscoveredFileCount": 100,
      "UpdateTime": "2021-02-30T11:08:08Z",
      "Paths": [
        "[\"/pathway/to/folder\",\"/pathway/to/folder\",\"/pathway/to/folder\"]"
      ],
      "RetrievedFileCount": 80,
      "JobId": "lrj-nfstest-ia-160****853-hshvw",
      "CreateTime": "2021-02-30T10:08:08Z",
      "StorageType": "InfrequentAccess"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。

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

    變更歷史

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