資源回收桶


資源回收筒簡介

  • OmniStor 系統提供「資源回收筒(MyRecycleBin)」的優化機制,加強用戶刪除檔案/目錄操作的彈性。

  • 用戶於一般資料夾中刪除的檔案/目錄可於資源回收筒中找到,用戶可操作是否還原指定檔案/目錄至目的地目錄之下或者永久清除該檔案/目錄。

  • 附註:一般資料夾(例如:同步資料夾)。

資源回收筒還原功能

  1. 呼叫 /folder/getpersonalsystemfolder/,取得資源回收筒 ID。

  2. 呼叫 /folder/browse/,瀏覽資源回收筒之下的目錄及檔案資訊(例如:File ID/Folder ID)。

  3. 指定欲還原的File ID/Folder ID,呼叫 /folder/restore/ 或是 /file/restore/ 進行還原。

資源回收筒永久清除功能

  1. 呼叫 /folder/getpersonalsystemfolder/,取得資源回收筒ID。

  2. 呼叫 /folder/browse/,瀏覽資源回收筒之下的目錄及檔案資訊(例如:File ID/Folder ID)。

  3. 指定欲永久清除的File ID/Folder ID,呼叫 /folder/clearrecyclebin/ 或是 /file/clearrecyclebin/ 進行永久清除。


還原資源回收筒中的指定目錄

  • 伺服器:InfoRelay

  • 目的:此 API 可供客戶端在資源回收筒中指定目錄還原至目的地目錄之下。

POST /folder/restore/

Input

<!--?xml version="1.0" encoding="utf-8"?--> <restore> <token>{ token }</token> <userid>{ User ID }</userid> <parent>{ Parent Folder ID }</parent> <!-- folderid element 可以重覆多次,指定多筆目錄 --> <folderid>{ 欲還原的 Folder ID#1 }</folderid> <folderid>{ 欲還原的 Folder ID#2 }</folderid> <folderid>{ …… }</folderid> <folderid>{ 欲還原的 Folder ID#N }</folderid> </restore>

Output

<!--?xml version="1.0" encoding="utf-8"?--> <restore> <status>{ Status Code }</status> <parent>{ 還原後的 Parent Folder ID }</parent> </restore>

回傳的狀態碼(Status Code)

狀態碼

狀態描述

狀態碼

狀態描述

0

Success。

2

Authentication Fail。

215

移動的目的地與來源目錄的上一層為同一目錄。

216

目的地目錄不存在。

218

被移動的指定目錄不存在。

225

上傳參數錯誤。

233

指定被移動的目錄與目的地目錄不在同一目錄樹下。

235

上傳參數的操作要求錯誤。

236

Target parent for restoring not assigned。

242

Insufficient capacity。

999

General Error。


還原資源回收筒中的指定檔案

  • 伺服器:InfoRelay

  • 目的:此API可供客戶端在資源回收筒中指定檔案還原至目的地目錄之下。

POST /file/restore/

Input

<!--?xml version="1.0" encoding="utf-8"?--> <restore> <token>{ token }</token> <userid>{ User ID }</userid> <parent>{ Parent Folder ID }</parent> <!-- fileid element 可以重覆多次,指定多筆檔案 --> <fileid>{ 欲還原的 File ID#1 }</fileid> <fileid>{ 欲還原的 File ID#2 }</fileid> <fileid>{ …… }</fileid> <fileid>{ 欲還原的 File ID#N }</fileid> </restore>

Output

回傳的狀態碼(Status Code)

狀態碼

狀態描述

狀態碼

狀態描述

0

Success。

2

Authentication Fail。

215

移動的目的地與來源目錄之上一層為同一個目錄。

216

移動的目的地目錄不存在。

218

目錄不存在或已刪除。

219

檔案不存在或已刪除。

225

上傳參數錯誤。

233

指定被移動的目錄與目的地目錄不在同一目錄樹下。

235

上傳參數的操作要求錯誤。

236

Target parent for restoring not assigned。

242

Insufficient capacity。

999

General Error。


永久清除資源回收筒中的指定目錄

  • 伺服器:InfoRelay

  • 目的:此 API 可供客戶端在資源回收筒中永久清除指定的目錄。若欲清除的目錄下有檔案/目錄,也將一併清除。若指定的目錄為資源回收筒本身,那麼將一次清空資源回收桶中所有的檔案/目錄。

POST /folder/clearrecyclebin/

Input

Output

回傳的狀態碼(Status Code)

狀態碼

狀態描述

狀態碼

狀態描述

0

Success。

2

Authentication Fail。

3

Payload is not validate。

225

參數值不在容許的定義域內(例如:不屬於資源回收筒的目錄)。

999

General Error。


永久清除資源回收筒中的指定檔案

  • 伺服器:InfoRelay

  • 目的:此 API 可供客戶端在資源回收筒中永久清除指定的檔案。

POST /file/clearrecyclebin/

Input

Output

回傳的狀態碼(Status Code)

狀態碼

狀態描述

狀態碼

狀態描述

0

Success。

2

Authentication Fail。

3

Payload is not validate。

225

參數值不在容許的定義域內(例如:不屬於資源回收筒的檔案)。

999

General Error。