查詢已刪除的檔案或目錄。
介面說明
僅通用型 NAS 支援該功能。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
1ca404**** |
| FileId |
string |
是 |
待查詢目錄的 FileId。 此欄位為 NFS inode 編號。當資源回收筒為空時，可使用 FileId=2（根目錄 inode）直接呼叫本介面，用於驗證介面可達性或查詢根目錄下的資源回收筒內容。其他有效 FileId 可以透過呼叫 ListRecentlyRecycledDirectories 介面查詢 FileId 資訊。 |
04***08 |
| NextToken |
string |
否 |
下一頁識別碼，首次查詢無需傳入。 如果一次查詢結果並未完整返回所有的檔案和目錄，則返回 NextToken 不為空。 您可以在查詢中上傳正確的 NextToken 繼續查詢。 |
1256****25 |
| MaxResults |
integer |
否 |
每次查詢返回檔案或目錄的個數。 取值範圍：10~1000 預設值：100 |
100 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| NextToken |
string |
下一頁識別碼。 如果一次查詢結果並未完整返回所有的檔案和目錄，則返回 NextToken 不為空。您可以在查詢中上傳正確的 NextToken 繼續查詢。 |
無 |
| Entries |
array<object> |
資源回收筒中檔案或目錄的資訊集合。 |
|
|
object |
|||
| FileId |
string |
檔案或目錄的 FileId。 |
04***08 |
| Type |
string |
返回物件類型。包括：
|
File |
| Name |
string |
檔案或目錄刪除前的名稱。 |
test001 |
| DeleteTime |
string |
檔案或目錄被刪除的時間。按照 ISO 8601 標準表示，並使用 UTC 時間。格式為：yyyy-MM-ddTHH:mm:ssZ。 |
2021-05-30T10:08:08Z |
| Inode |
string |
檔案或目錄的 inode。 |
04***08 |
| ATime |
string |
最近存取時間。按照 ISO 8601 標準表示，並使用 UTC 時間。格式為：yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| MTime |
string |
最近修改時間。按照 ISO 8601 標準表示，並使用 UTC 時間。格式為：yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| CTime |
string |
中繼資料最近修改時間。按照 ISO 8601 標準表示，並使用 UTC 時間。格式為：yyyy-MM-ddTHH:mm:ssZ。 |
2019-10-30T10:08:08Z |
| Size |
integer |
檔案大小。單位：Byte。 當 Type=Directory 時，返回為 0。 |
1073741824 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"NextToken": "無",
"Entries": [
{
"FileId": "04***08",
"Type": "File",
"Name": "test001",
"DeleteTime": "2021-05-30T10:08:08Z",
"Inode": "04***08",
"ATime": "2019-10-30T10:08:08Z",
"MTime": "2019-10-30T10:08:08Z",
"CTime": "2019-10-30T10:08:08Z",
"Size": 1073741824
}
]
}錯誤碼
|
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 | InvalidFileId.NotFound | The specified FileId(%FileId) does not exist. | 指定的檔案或目錄不存在。 |
| 404 | InvalidParameter.InvalidNextToken | The specified NextToken is invaild. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。