Azure 儲存體 REST API 參考

Microsoft Azure 儲存體服務的 REST API 可讓您透過儲存體模擬器,以程式設計方式存取 Azure 或開發環境中的 Blob、佇列、表格和檔案服務。

所有儲存體服務都可透過 REST API 存取。 您可以從 Azure 中執行的服務內部存取儲存體服務,或是直接透過網際網路從可以傳送 HTTP/HTTPS 要求和接收 HTTP/HTTPS 回應的任何應用程式存取儲存體服務。

重要

Azure 儲存體服務支援 HTTP 和 HTTPS,但強烈建議使用 HTTPS。

儲存體帳戶

儲存體服務的所有存取作業都是透過儲存體帳戶進行。 儲存體帳戶是最高層級的命名空間,用於存取每項基本服務; 這也是授權的基礎。

儲存體服務的 REST API 會將儲存體帳戶公開為一項資源。

Blob 服務

Blob 服務可儲存實體,例如二進位檔案和文字檔案。 Blob 服務的 REST API 公開兩個資源:容器和 Blob。 容器就像資料夾,其中包含一組 Blob;每個 Blob 都必須位於容器中。 Blob 服務會定義三種類型的 Blob:

  • 區塊 Blob,已針對資料流最佳化。 此類型的 Blob 只在 2009-09-19 之前的版本提供。

  • 分頁 Blob 已針對隨機讀取/寫入作業最佳化,並提供寫入 Blob 之位元組範圍的功能。 分頁 Blob 適用於 2009-09-19 版及更新版本。 這些主要用於支援 Azure VM 的 VHD 檔案。

  • 附加 Blob,僅針對附加作業優化。 附加 Blob 僅適用于版本 2015-02-21 和更新版本。

容器和 Blob 支援將使用名稱/值組格式之使用者定義的中繼資料,指定為要求作業的標頭。

開發人員可以使用 Blob 服務的 REST API,建立類似檔案系統的階層式命名空間。 Blob 名稱可透過可設定的路徑分隔符號將階層編碼。 例如,Blob 名稱 MyGroup/MyBlob1MyGroup/MyBlob2 代表 Blob 的虛擬層級。 Blob 的列舉作業支援以類似檔案系統的方式周遊虛擬階層,因此您可以傳回組織在群組下的一組 Blob。 例如,您可以列舉組織在 MyGroup/下的所有 Blob。

區塊 Blob 可透過下列兩種方式中的其中一種來建立。 您可以上傳具有單一 Put Blob 作業的 Blob,或是將 Blob 上傳為具有 Put Block 作業的區塊集,並使用 Put Block List 作業將區塊認可至 Blob。

分頁 Blob 是以呼叫 Put Blob的大小上限來建立和初始化。 若要將內容寫入分頁 Blob,請呼叫 放置頁面 作業。

您可以呼叫 Put Blob來建立附加 Blob。 使用 Put Blob 作業建立的附加 Blob 不包含任何內容。 若要將內容寫入附加 Blob,您可以藉由呼叫 附加區塊 作業,將區塊新增至 Blob 結尾。 不支援更新或刪除現有的區塊。 每個區塊的大小可以不同,最多 4 MiB。 附加 Blob 的大小上限為 195 GiB,而附加 Blob 可以包含不超過 50,000 個區塊。

Blob 支援條件式更新作業,此作業有助於並行控制及有效率地上傳。

您可以呼叫 取得 Blob 作業來讀取 Blob。 用戶端可讀取整個 Blob 或任意範圍的位元組。

如需 Blob 服務 API 參考,請參閱 Blob 服務 REST API

佇列服務

佇列服務提供服務內部及服務之間可靠且持續的傳訊。 佇列服務的 REST API 公開兩個資源:佇列和訊息。

佇列支援將使用名稱/值組格式之使用者定義的中繼資料,指定為要求作業的標頭。

每個儲存體帳戶可以包含不限數目的訊息佇列,這些訊息佇列在帳戶中具有唯一的名稱。 每個訊息佇列可以包含不限數目的訊息。 訊息的大小上限限制為 2011-08-18 版的 64 KiB 和舊版的 8 KiB。

從佇列讀取訊息之後,取用者應該可以處理訊息,並加以刪除。 讀取訊息之後,在指定間隔內,其他取用者將無法看見此訊息。 如果間隔到期時尚未刪除此訊息,則會恢復顯示此訊息,以供其他取用者處理。

如需佇列服務的詳細資訊,請參閱 佇列服務 REST API

表格服務

表格服務以資料表格式提供結構化儲存體。 資料表服務支援實作 OData 通訊協定的 REST API。

在儲存體帳戶內,開發人員可以建立資料表。 資料表會將資料以實體儲存。 實體是具名屬性和其值的集合,類似資料列。 表格會加以分割,以支援跨儲存體節點進行負載平衡。 每個資料表會以第一個屬性做為資料分割索引鍵,以指定實體所屬的資料分割。 第二個屬性是識別指定資料分割中實體的資料列索引鍵。 資料分割索引鍵和資料列索引鍵的組合會形成主索引鍵,可唯一識別資料表中的每個實體。

表格服務不會強制執行任何結構描述。 開發人員可以選擇在用戶端實作及強制執行結構描述。 如需資料表服務的詳細資訊,請參閱 資料表服務 REST API

檔案服務

伺服器訊息區 (SMB) 通訊協定是目前使用於內部部署的慣用檔案共用通訊協定。 Microsoft Azure 檔案服務可讓客戶利用 Azure 的雲端基礎結構即服務 (IaaS) SMB 的可用性和延展性,而不需重新編寫 SMB 用戶端應用程式。

Azure 檔案服務也為傳統要安裝、設定及操作經常是既複雜且昂貴的「直接連接存取 (DAS)」和「存放區域網路 (SAN)」解決方案提供引人注目的替代方式。

儲存在 Azure 檔案服務共用中的檔案,可透過 SMB 通訊協定來加以存取,也可以透過 REST API。 檔案服務提供下列四個資源:儲存體帳戶、共用、目錄和檔案。 共用提供整理一組檔案的方式,也可以裝載為在雲端中主控的 SMB 檔案共用。

另請參閱

Blob 服務 REST API佇列服務 REST API資料表服務 REST API檔案服務 REST API