云存储服务开发指南

雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第1頁            雲存儲服務（AspenCloudStorage）雲存儲服務開發指南定義下一代雲存儲 Power‐All網路有限公司 (2009年6月11日 1.03版本)         雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第2頁 目錄  1.更新日誌…………………………………………………………………………………….………………   4  2.概述…………………………………………………………………………………………………….………   5  3.關於 Aspen Cloud Storage …………………………………………………………………………   6  4.技能需求? …………………………………………………………………………………………..…….   8  5.術語………………………………………………………..………………………………………….………  11  6.更多關於Aspen Cloud Storage .….……………………………………………………………….. 12  7.更多關於Box ………………….…………………….……….…….…………………………….……  13  8.更多關於檔………………………………………………………….……………………………...  15  9.認證………………..…….……………………………………………………………………………..…..  16  10.存取控制清單(ACL)…….……..…………………………………..………………………….……  20  11.結算方式…….…………………………………....……………………………………………………..  22  12.編程需知………………………….…………………………..………………………………………….  23  13.雲盒子(Box) 服務清單….…………….…………………….………………………….…… 25  14.雲盒子(Box) 服務–創建雲盒子(Box) (ID : 1.1)…………………..…………… 26  15.雲盒子(Box) 服務–刪除雲盒子(Box) (ID : 1.2)……………………………..…  28  16.雲盒子(Box) 服務–列出所有雲盒子(Box)清單(ID : 1.3)………….….. 30  17.雲盒子(Box) 服務–列出雲盒子(Box) 中的檔清單(ID : 1.4)..……  32  18.雲盒子(Box) 服務–獲取雲盒子(Box) 位置(ID : 1.5)……………………….  35  19.雲盒子(Box) 服務–獲取雲盒子(Box) ACL (ID : 1.6)………………………….  37  20.雲盒子(Box) 服務–設置雲盒子(Box) ACL (ID : 1.7)………..………………..  39 雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第3頁 目錄 21.文件Web服務………………………………………………………………………………………… 42  22.文件Web服務–上傳文件(ID : 2.1)…….…………………….……….…….……….…. 43  23.文件Web服務–刪除文件(ID : 2.2)……………………….……………………………..  47  24.文件Web服務–獲得文件案屬性(ID : 2.3)…………………………………..………  49  25.文件Web服務–獲取文件(ID : 2.4)………………..……………………………………  51  26.文件Web服務–獲取文件ACL (ID : 2.5)……....…………………………………….  57  27.文件Web服務–設置文件ACL (ID : 2.6)…………….………………………..………  59  28.檔Web服務–檔重命名(ID : 2.7) …………….…………………………..….……………  62  29.Web服務清單(包括其它服務) ……………………….……………………..…….……  66  30.其它Web服務‐獲取全部網格(ID : 3.1)…………….……………………..……………  67  31.錯誤處理…………………………….………………………..……………………………………..…. 69  32.用HTTP Form POST 方式上載檔案………………………………………………………….   72  33.編碼示例–簽名生成……………………………………….……………………….……..…… 76  34.編碼示例–創建雲盒子（box）……………..………………………………..………….  77  35.編碼示例–刪除雲盒子（box）.…………………………………………………….……. 78  36.編碼示例–顯示已有雲盒子（box）…………………………………………………… 79  37.編碼示例–設置雲盒子（box）訪問ACL……….…………………………………. 80  38.編碼示例–上傳文件……….………………………………………………………..…..…….. 81  39.編碼示例–刪除文件……….……………………………………………………………………. 82  40.編碼示例–獲取文件案屬性……….…………………………………………………….….. 83  雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第4頁 1.更新日誌  更改項目 頁數  日期 支援HTTP POST 檔案上載方式 16, 72 2009‐06‐11 限制檔案名稱中斜線的昀大使用數量. (現在為12個) 15, 43, 62 2009‐06‐11 昀長檔案名稱現增加到160字. 15 2009‐06‐11 不允許點(.)字元14 2009‐05‐25 支援新的錯誤傳回值.OwnerACPrb26, 28… 2008‐12‐09 採用RFC1738格式作為URL Encode第9部份 2008‐12‐09 通過HTTP報頭獲取部分檔，“範圍”(Range).y用戶可開發文件下載失敗恢復y使用者可通過多方下載以提高下載性能43 2008‐11‐01 添加web服務API, get_all_grids(),顯示全球所有可用網格。 54 2008‐11‐01 添加Web服務 API, file_rename(), 同一雲盒子（box）內的檔重命名。 50 2008‐11‐01 支援在當前API方法中設置報頭資訊(如If‐Match, If‐None‐Match, If‐Modified‐Since, If‐Unmodified‐Since) in existing API, get_file()(ID : 2.4) and rename_file()(ID : 2.7).  44, 51 2008‐11‐01 於get_file_attribute(ID : 2.3) 方法上,添加了新的屬性BoxCreationDate  24 2008‐11‐01 添加了新的屬性LastUpdateDate‐list_files_inbox (ID : 1.4) ‐get_file_attribute (ID : 2.3) LastUpdateDate是新的屬性,之前上載的舊檔案沒有提供此屬性.你可更新檔案(例如:更改檔名)以提供此屬性. 27, 41 2008‐11‐01 在所有的XML輸出上,支援ISO8601日期格式(例: 2008‐10‐30T09:06:23Z). ‐list_all_box API (ID : 1.3) ‐list_files_inbox (ID : 1.4) ‐get_file_attribute (ID : 2.3) 17, 24, 27, 41 2008‐11‐01      雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第5頁 1.概述  隨著Web2.0環境的使用，使數字媒體與用戶生成內容形成了極速增長的局面。視頻流媒與大型檔共用越來越受網民青睞。每日都有大量新網站落戶並提供免費檔與視頻流媒下載服務。此類服務對於存儲空間，CPU電源及帶寬有著極大的要求。建立及維護一個高擴展性與高可靠性網絡存儲，是一項複雜而且昂貴的任務。Power-All的AspenCloudStorage存儲服務可解決以上所有傳統存儲所存在的問題，用戶以較低的價格享受高質量與高可用性的存儲服務。提供簡單實用的RESTWeb服務，開發人員只需使用AspenCloudStorage提供的Web服務調用功能在遠程存儲內進行文件存儲，而無需為怎樣進行後端存儲與維護工作而擔憂。該web服務提供高可用性，高穩定性與安全的數據存儲，易於理解，操作如進行本地檔(Local File)存儲處理一樣簡單。根據該開發指南，開發人員可以精確的瞭解如何使用我們提供的存儲web服務來滿足用戶的市場需求與目標。            雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第6頁 2.關於 Aspen Cloud Storage  有關傳統存儲服務  什麼是傳統存儲服務?它包括廣泛的存儲設備和軟件備份，如備份磁帶，SAN，NAS等存儲軟件與應用程式。存儲設備的部署與維護需要專業技術的支持。如果用戶需要在不同的網絡中進行多份數據備份，其成本是用戶需要考慮的主要因素。  傳統存儲的弊端  y購買存儲設備與軟件費用高昂y要求專業的存儲部署與維護知識y在部署存儲系統前需詳細的設計方案與設施圖。y需要長期雇用存儲系統維護方面的專業IT人員y複雜且昂貴的設備與軟件升級費用y在部處初期，網絡帶寬難以預測，而且數據中心線路與機架租金昂貴什麼是Aspen Cloud Storage?  Aspen Cloud Storage：全寫(Cloud Based Service Storage)屬於Paas(平臺即服務)，向用戶提供高質量，高可用的web存儲服務。通過RESTfulweb服務，用戶可在Aspen Cloud Storage上存儲檔並隨時，隨地擷取資訊。另外，Aspen Cloud Storage服務採用按需付款模式，用戶僅需為其所使用的服務付費（與電費性質相同）。無前期費用便可即時擴展。這種結算方式適用於企業，可避免估值過高而造成的資源浪費。對於用戶來說，Aspen Cloud Storage是一種黑匣子存儲服務。用戶無需進行後臺管理與維護。Aspen Cloud Storage會解決所有後端操作，而用戶只需考慮上傳足夠的文件。 雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第7頁 3.關於Aspen Cloud Storage  ( 續上 )  AspenCloudStorage優勢 y無前期費用，用戶無需購買存儲軟件與硬體 y啟動時無需考慮硬體與網絡帶寬 y合理的結算模式–“按需使用” y無需擔憂日後硬體與軟件的升級 y企業內部無需專業存儲管理平臺 y數據冗餘與無限存儲 y使用80埠(Port 80)降低由防火牆造成的故障 y可隨時隨地進行應用 y易於掌握及開發 y獨立編程語言，開發人員可使用自己慣用的語言編寫AspenCloudStorage服務程式。                 雲存儲服務開發指南 版權所有© 2008 Power‐All網路有限公司   第8頁 4.技術要求?  在開始使用服務之前，用戶也許會問“應用AspenCloudStorage服務需要什麼技術？”。對於程式員來說，這個問題比價格更為重要。AspenCloudStorage服務提供全球昀受青睞的網絡模式，如REST。所有提供的web服