建立一個徹底刪除資源回收筒中暫存的檔案或目錄的任務。
介面說明
僅通用型 NAS 檔案系統支援該功能。
徹底刪除目錄時,目錄中的內容會被遞迴清理。
單個檔案系統一次只能執行一個徹底刪除任務。正在徹底刪除檔案或目錄時,無法發起新的恢複或清理任務。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
nas:CreateRecycleBinDeleteJob |
delete |
*FileSystem
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| FileSystemId |
string |
是 |
檔案系統 ID。 |
1ca404**** |
| FileId |
string |
是 |
待徹底刪除檔案或目錄的 FileId。 您可以通過調用 ListRecycledDirectoriesAndFiles 介面查詢已刪除資料的 FileId 資訊。 |
04***08 |
| ClientToken |
string |
否 |
保證請求等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元,且不能超過 64 個字元。更多資訊,請參見如何保證等冪性。 說明
若您未指定 ClientToken,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
123e4567-e89b-12d3-a456-42665544**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求 ID。 |
98696EF0-1607-4E9D-B01D-F20930B6**** |
| JobId |
string |
任務 ID。 |
8C****C54 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
"JobId": "8C****C54"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IllegalCharacters | The parameter contains illegal characters. | 參數非法。 |
| 400 | MissingFileSystemId | FileSystemId is mandatory for this action. | 未指定FileSystemId參數。 |
| 400 | MissingFileId | FileId is mandatory for this action. | 缺少FileId參數。 |
| 400 | InvalidParameter.KMSKeyId.KMSUnauthorized | KMS is not authorized. | KMS服務未被授權訪問。 |
| 400 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK needs to be enabled. | 指定的CMK被disable需要處在啟用狀態。 |
| 403 | OperationDenied.Conflict | The operation is in conflict with (% JobId). Please try again later. | 請求與其他job有衝突,請稍後再試。 |
| 403 | OperationDenied.TooManyRunningJobs | The maximum number of running job is one. Please try again later. | 運行中的job不能超過1個,請稍後再試。 |
| 404 | InvalidFileSystem.NotFound | The specified file system does not exist. | 指定的檔案系統不存在。 |
| 404 | InvalidFileId.NotFound | The specified FileId(%FileId) does not exist. | 指定的檔案或目錄不存在。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。