CreateRecycleBinRestoreJob - File Storage NAS

恢復一個暫存回收站中的檔案。

介面說明

僅通用型 NAS 檔案系統支援該功能。
單個檔案系統一次只能執行一個檔案恢復或清理任務。正在恢復檔案時，無法發起新的檔案恢復或清理任務。
單個恢復任務只能恢復一個檔案或目錄，恢復指定目錄會遞迴恢復目錄下的所有檔案。
檔案被恢復後會進行資料整理，資料整理期間讀取請求效能稍有下降。

調試

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

調試

授權資訊

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

請求參數

名稱	類型	必填	描述	樣本值
FileSystemId	string	是	檔案系統 ID。必填參數。取得方式：呼叫 DescribeFileSystems 查詢檔案系統清單以取得 FileSystemId 呼叫 CreateFileSystem 建立檔案系統後返回使用說明：本介面僅適用於通用型 NAS 檔案系統呼叫本介面前，需確保目標檔案系統已開啟回收站功能	1ca404****
FileId	string	是	待恢復的檔案或目錄的 FileId。您可以透過呼叫 ListRecycledDirectoriesAndFiles 介面查詢已刪除資料的 FileId 資訊。	04***08
TargetFileId	string	是	檔案恢復後所儲存目錄的 FileId。您可以透過呼叫 ListRecentlyRecycledDirectories 介面查詢執行過刪除操作的目錄 TargetFileId 資訊。您可以透過呼叫 ListDirectoriesAndFiles 介面查詢檔案系統中已存在目錄 TargetFileId 資訊。特殊說明：檔案系統根目錄的 FileId 固定為 `2`，可直接作為 TargetFileId 將檔案恢復到根目錄，無需查詢即可使用。	13***15
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。	rb-10**491ff-r-162**165400

樣本

正常返回樣本

JSON格式

{
  "RequestId": "98696EF0-1607-4E9D-B01D-F20930B6****",
  "JobId": "rb-10****491ff-r-162****165400"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	IllegalCharacters	The parameter contains illegal characters.	參數無效。
400	MissingFileSystemId	FileSystemId is mandatory for this action.	未指定 FileSystemId 參數。
400	MissingTargetFileId	TargetFileId is mandatory for this action.	缺少 TargetFileId 參數。
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 已被停用，需處於啟用狀態。
403	OperationDenied.RecycleBinDisabled	The operation is denied because the recycle bin is disabled.	請求無法在資源回收筒關閉狀態下執行。
403	OperationDenied.Conflict	The operation is in conflict with (% JobId). Please try again later.	請求與其他工作有衝突，請稍後再試。
403	OperationDenied.TooManyRunningJobs	The maximum number of running job is one. Please try again later.	執行中的 job 不能超過 1 個，請稍後再試。
403	InvalidTargetFileId.NotDirectory	The specified TargetFileId(% TargetFileId) is not directory.	指定的目標不是目錄。
404	InvalidFileSystem.NotFound	The specified file system does not exist.	指定的檔案系統不存在。
404	InvalidFileId.NotFound	The specified FileId(%FileId) does not exist.	指定的檔案或目錄不存在。
404	InvalidTargetFileId.NotFound	The specified TargetFileId(%TargetFileId) does not exist.	指定的目標目錄不存在。

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

變更歷史

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