資源回收桶

資源回收筒簡介

• 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/進行永久清除。

還原資源回收筒中的指定目錄(/folder/restore/)

伺服器：InfoRelay

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

/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)

還原資源回收筒中的指定檔案(/file/restore/)

伺服器：InfoRelay

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

/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

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

回傳的狀態碼(Status Code)

永久清除資源回收筒中的指定目錄(/folder/clearrecyclebin/)

伺服器：InfoRelay

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

/folder/clearrecyclebin/

Input

<clearrecyclebin> <token>{ token }</token> <userid>{ User ID }</userid> <!-- folderid element 可以重覆多次，指定多筆目錄 --> <folderid>{ 欲刪除的 Folder ID#1 }</folderid> <folderid>{ 欲刪除的 Folder ID#2 }</folderid> <folderid>{ …… }</folderid> <folderid>{ 欲刪除的 Folder ID#N }</folderid> </clearrecyclebin>

Output

<!--?xml version="1.0" encoding="utf-8"?--> <clearrecyclebin> <status>{ Status Code }</status> <scrip>{ scrip }</scrip> </clearrecyclebin>

回傳的狀態碼(Status Code)

永久清除資源回收筒中的指定檔案(/file/clearrecyclebin/)

伺服器：InfoRelay

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

/file/clearrecyclebin/

Input

<!--?xml version="1.0" encoding="utf-8" ?--> <clearrecyclebin> <token>{ token }</token> <userid>{ User ID }</userid> <!-- fileid element 可以重覆多次，指定多筆檔案 --> <fileid>{ 欲刪除的 File ID#1 }</fileid> <fileid>{ 欲刪除的 File ID#2 }</fileid> <fileid>{ …… }</fileid> <fileid>{ 欲刪除的 File ID#N }</fileid> </clearrecyclebin>

Output

<!--?xml version="1.0" encoding="utf-8" ?--> <clearrecyclebin> <status>{ Status Code }</status> <scrip>{ scrip }</scrip> </clearrecyclebin>

回傳的狀態碼(Status Code)