閱讀387 返回首頁    go 阿裏雲

阿裏雲歸檔存儲簡介__API使用手冊_歸檔存儲-阿裏雲

歡迎使用阿裏雲歸檔存儲。歸檔存儲作為阿裏雲數據存儲服務體係的一部分，提供了極低成本的數據存儲服務。適合各種離線數據，包括但不局限於數字媒體、企業歸檔資料、科學實驗數據、個人備份等。用戶可以將數據進行幾個月、幾年甚至幾十年的長時間存儲。同時不需要任何基礎設施的投入，即可擁有無限擴容、可選擇地域的低成本數據歸檔方案，也免去了後續數據的管理維護成本。需要注意的是，存放於歸檔存儲的數據大部分時間會處於“休眠”狀態，而對數據的“喚醒”操作需要消耗一些時間和資源，因此如果您對數據長期穩定存儲的需求較高，而對數據的訪問和讀取速度要求較低的話，歸檔存儲會是一個理想的選擇。用戶可以使用本文檔介紹的API對歸檔存儲進行相關操作。在使用這些接口前，請確保已充分了解歸檔存儲產品說明、使用協議和收費方式。

若要了解更多相關信息，請訪問阿裏雲歸檔存儲官方網站 www.aliyun.com/product/oas。

基本概念

阿裏雲歸檔存儲的數據模型，由Vault（目錄）和Archive（文檔）組成。

Archive

在歸檔存儲中，用戶操作的基本數據單元是Archive，它需要包含在Vault（1.1.2）中。Archive可以是任意類型的數據。上傳Archive（4.2.1）時，文檔大小限製在6GB；如果文檔大小超出6GB，請使用Multipart Upload（1.1.4）方式。Archive包含ArchiveID、Description和Data等Data信息，其中ArchiveID是Archive的唯一標識，用戶上傳Archive時由係統自動生成並返回給用戶，Description是用戶對該Archive的描述，Data是Archive的數據。Archive目前僅支持通過API進行操作。

Vault

Vault是歸檔存儲提供給用戶用於管理Archive的目錄，也是計費、權限控製等功能的管理單位。Vault名稱在每個用戶的每個Region（1.1.3）下唯一，每個用戶在每個Region最多可以創建10個Vault，Vault不支持嵌套。每個Vault裏可以包含任意數量的Archive。Vault可以通過阿裏雲管理控製台、API兩種方式進行創建、刪除等操作。

Vault的命名規範：

  • 隻能包含小寫字母、數字、下劃線（_）、短橫線（-）；
  • 必須以小寫字母或者數字開頭和結尾；
  • 長度必須在 3-63 字節之間；

Region

Region是歸檔存儲集群的標識。各Region間的操作相互獨立。當前可用Region列表參見2.1.1。

Multipart Upload

Multipart Upload是把單個文檔分段上傳的方式，每段稱之為Part（1.1.5），目的是為了便於用戶上傳較大的文檔。使用Multipart Upload最大可以上傳10000*4GB的文檔。不僅如此，多段上傳還支持獨立、任意順序、甚至並行上傳這些段。如果某段上傳失敗，隻需要重新上傳該段即可。我們建議用戶在上傳大於100MB的文檔時使用這種方式。該上傳操作是異步方式，用戶需要首先新建Multipart Upload任務，指定每次需要上傳的Part字節長度，該長度值必須能夠被1MB整除，且介於32MB到4096MB之間。任務啟動成功後，歸檔存儲會為該任務分配唯一的Upload ID，用戶需要使用該ID作為標識完成後續Part的上傳與合並。需要注意的是該任務自創建起24小時後，會自動失效。

Part

啟動Multipart Upload任務成功以後，單獨上傳的某個範圍內的文檔數據稱為Part。用戶上傳時需要指定Part在文檔中所屬的範圍。當所有Part都上傳成功以後，用戶還需要主動發起一次Part合並請求（4.3.6），才能將上傳的數據完整地提交到歸檔存儲，否則任務創建超出24小時以後，用戶在該任務中上傳的數據將會丟失。

Job

歸檔存儲的Vault/Archive的內容提取為異步操作，用戶需要首先提交指定類型的Job完成對數據的“喚醒”，然後通過查詢Job狀態來確認Job是否完成。在正常情況下，任務會在4小時內完成。Job完成以後，就可以獲取Job Output。Job類型可以是inventory-retrieval或archive-retrieval。前者獲取到的Job Output是Job指定Vault的Archive列表信息，後者則是Job指定Archive的數據內容。注意inventory-retrieval類型Job獲取到的Archive列表信息是由係統每天定期掃描生成的信息，不是實時數據。

Job類型還可以是pull-from-oss或push-to-oss。這兩種Job類型為方便阿裏雲用戶在歸檔存儲產品與OSS產品之間實現數據歸檔、提檔功能，並幫助用戶實現無中轉方式的跨產品數據傳輸。pull-from-oss類型的Job用於將用戶在OSS產品上的Object歸檔到歸檔存儲產品。 push-to-oss類型的Job用於將用戶在歸檔存儲產品上的Archive，提檔到OSS產品。 這兩種類型的Job依賴用戶對歸檔存儲產品授予用戶OSS訪問權限。

Access Key ID、Access Key Secret

歸檔存儲會對每個訪問的請求進行身份驗證，請求中需要包含簽名（Signature）信息。歸檔存儲通過使用Access Key ID和Access Key Secret進行對稱加密的方法來驗證請求的發送者身份。Access Key ID和Access Key Secret由阿裏雲官方頒發給訪問者（可以通過阿裏雲官方網站申請和管理），其中Access Key ID用於標識訪問者的身份；Access Key Secret是用於加密簽名字符串和服務器端驗證簽名字符串的密鑰，請嚴格保密，請勿泄露給第三方。

ContentEtag、TreeEtag

歸檔存儲會對上傳的單文檔或者文檔分段，進行ContentEtag和TreeEtag兩種方式的數據校驗。ContentEtag是對數據進行md5sum校驗的數值，TreeEtag是對數據按照tree-hash算法校驗的數值（tree-hash算法參考：《歸檔存儲 API調用方式-2.5.2 x-oas-tree-etag校驗碼》）。

功能簡介

Vault操作

歸檔存儲目前支持Vault創建（4.1.1）、刪除（4.1.2）、單個Vault信息查詢（4.1.3）以及Vault列表查詢（4.1.4），需要注意的是：

  • 如果Vault中包含有Archive，刪除操作會失敗；
  • Vault列表查詢不支持跨Region操作，同一請求隻能獲取單個Region下用戶的Vault列表；
  • 用戶獲取Vault統計信息時，該信息不是實時更新。返回消息中Last Inventory（最後統計時間）的標識，反映了該信息的最後統計時間，信息更新來自歸檔存儲係統定期掃描統計或者由用戶主動發起的inventory-retrieval類型Job；

Vault創建操作會返回Vault ID，其他的Vault操作都需要使用該ID來完成。

Archive操作

Archive操作包括上傳（4.2.1）和刪除（4.2.2）。Archive上傳成功以後，歸檔存儲會返回唯一的Archive ID，刪除操作需要使用該Archive ID。

Multipart Upload操作

Multipart Upload操作包括任務初始化（4.3.1）、刪除（4.3.3）、任務列表查詢（4.3.2）。初始化操作成功以後會啟動一個多段上傳的任務並返回Upload ID，後續的Part上傳（4.3.4）、已上傳完成的Part列表查詢（4.3.5）以及Part合並操作（4.3.6）都需要指定該Upload ID。用戶可以通過Multipart Upload刪除操作（4.3.3）主動取消相應Archive的多段上傳；多個Multipart Upload任務可以通過任務列表查詢（4.3.2）來獲取任務信息。任務的刪除和任務列表查詢同樣也需要使用初始化成功返回的Upload ID進行。

Job操作

Job操作包括Job初始化（4.4.1）、Job Output下載、Job列表查詢以及Job狀態查詢。Job初始化成功以後會創建指定類型的Job，開始數據準備並返回Job ID。準備的過程中，用戶可以使用Job狀態查詢（4.4.4）來查看Job的狀態，待Job完成後使用Job Output下載（4.4.2）來獲取所需的數據。正在進行的或近期完成的Job操作可以通過Job列表查詢（4.4.3）來查看。後三個Job操作都需要指定初始化Job成功後返回的Job ID。

最後更新：2016-11-23 19:54:05

  上一篇：go OSS轉儲快速使用__快速入門_歸檔存儲-阿裏雲
  下一篇：go API調用方式__API使用手冊_歸檔存儲-阿裏雲