全部產品
Search
文件中心

File Storage NAS:ListRecentlyRecycledDirectories

更新時間:Sep 03, 2026

查詢最近執行過刪除操作的目錄。

介面說明

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

前置條件

呼叫本介面前,需確保目標檔案系統已啟用資源回收筒功能。如果檔案系統未啟用資源回收筒,呼叫本介面將無法傳回最近刪除的目錄清單。

啟用資源回收筒

如需啟用資源回收筒功能,請呼叫 EnableRecycleBin 介面。啟用後,檔案系統刪除的目錄將進入資源回收筒,可透過本介面查詢最近刪除的目錄清單。

調試

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

調試

授權資訊

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

請求參數

名稱

類型

必填

描述

樣本值

FileSystemId

string

是

檔案系統 ID。

1ca404****

NextToken

string

否

下一頁識別碼,首次查詢無需傳入。

如果一次查詢結果並未完整傳回所有的目錄,則傳回的 NextToken 不為空。您可以在查詢中上傳正確的 NextToken 繼續查詢。

1256****25

MaxResults

integer

否

每次查詢傳回目錄的個數。

取值範圍:10~1000

預設值:100

100

返回參數

名稱

類型

描述

樣本值

object

Schema of Response

RequestId

string

請求 ID。

9E15E394-38A6-457A-A62A-D9797C9A****

NextToken

string

下一頁識別碼。

如果一次查詢結果並未完整傳回所有的目錄,則傳回的 NextToken 不為空。您可以在查詢中上傳正確的 NextToken 繼續查詢。

1256****25

Entries

array<object>

最近執行過刪除操作的目錄資訊。

object

FileId

string

目錄 ID。

04***08

Path

string

目錄的絕對路徑。

/a/b

Name

string

目錄的名稱。

b

LastDeleteTime

string

該目錄最近一次執行刪除操作的時間。按照 ISO 8601 標準表示,並使用 UTC 時間。格式為:yyyy-MM-ddTHH:mm:ssZ。

2021-05-30T10:08:08Z

樣本

正常返回樣本

JSON格式

{
  "RequestId": "9E15E394-38A6-457A-A62A-D9797C9A****",
  "NextToken": "1256****25",
  "Entries": [
    {
      "FileId": "04***08",
      "Path": "/a/b",
      "Name": "b",
      "LastDeleteTime": "2021-05-30T10:08:08Z"
    }
  ]
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 IllegalCharacters The parameter contains illegal characters. 參數無效。
400 MissingFileSystemId FileSystemId is mandatory for this action. 未指定 FileSystemId 參數。
400 InvalidParameter.KMSKeyId.KMSUnauthorized KMS is not authorized. KMS 服務未被授權存取。
400 InvalidParameter.KMSKeyId.CMKNotEnabled The CMK needs to be enabled. 指定的 CMK 已被停用,需處於啟用狀態。
404 InvalidFileSystem.NotFound The specified file system does not exist. 指定的檔案系統不存在。
404 InvalidParameter.InvalidNextToken The specified NextToken is invaild.

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

變更歷史

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