Azure Blob 儲存體 REST API
Azure Blob 儲存體 會將文字和二進位數據儲存為雲端中的物件。 Blob 記憶體提供下列資源:記憶體帳戶、容器和 Blob。 在您的儲存體帳戶中,容器提供一個組織 Blob 集的方式。
您可以用下列兩種 Blob 類型中的一種,將文字和二進位資料進行儲存:
區塊 Blob,已針對資料流最佳化。
附加 Blob,其已針對附加作業優化。
分頁 Blob,已針對隨機讀取/寫入作業進行優化,並提供寫入 Blob 中某個字節範圍的能力。
如需詳細資訊,請參閱了解區塊 Blob、附加 Blob 和分頁 Blob。
Blob 記憶體的 REST API 會針對記憶體帳戶、容器和 Blob 定義 HTTP 作業。 API 包含下表列出的作業:
作業 | 資源類型 | 描述 |
---|---|---|
列出容器 | 帳戶 | 列出儲存體帳戶中所有的容器。 |
設定 Blob 記憶體屬性 | 帳戶 | 設定 Blob 記憶體的屬性,包括記錄和計量設定,以及預設服務版本。 |
取得 Blob 記憶體屬性 | 帳戶 | 取得 Blob 記憶體的屬性,包括記錄和計量設定,以及預設服務版本。 |
預檢 Blob 要求 | 帳戶 | 在傳送實際要求之前,先查詢 Blob 記憶體的跨原始來源資源分享 (CORS) 規則。 |
取得 Blob 記憶體統計數據 | 帳戶 | 擷取與 Blob 記憶體複寫相關的統計數據。 當儲存體帳戶啟用讀取權限的地理備援複寫時,這項作業只能用於次要位置端點。 |
取得帳戶資訊 | 帳戶 | 傳回指定帳戶的 SKU 名稱和帳戶種類。 |
取得使用者委派金鑰 | 帳戶 | 取得可用來簽署使用者委派共用存取簽章的金鑰。 此簽章會使用 Microsoft Entra 認證授與 Blob 記憶體中資源的存取權。 |
建立容器 | 容器 | 在儲存體帳戶中建立新容器。 |
取得容器屬性 | 容器 | 傳回容器之所有使用者定義的中繼資料和系統屬性。 |
取得容器中繼資料 | 容器 | 只傳回容器之使用者定義的中繼資料。 |
設定容器元數據 | 容器 | 設定容器的使用者定義中繼資料。 |
取得容器 ACL | 容器 | 取得容器的公用存取原則和任何儲存的存取原則。 |
Set Container ACL (設定容器 ACL) | 容器 | 設定容器的公用存取原則和任何儲存的存取原則。 |
租用容器 | 容器 | 在容器上建立及管理刪除作業的鎖定。 |
刪除容器 | 容器 | 刪除容器及其包含的任何 Blob。 |
列出 Blob | 容器 | 列出容器中所有的 Blob。 |
放置 Blob | 區塊、附加和分頁 Blob | 建立新的 Blob,或取代容器中現有的 Blob。 |
取得 Blob | 區塊、附加和分頁 Blob | 從 Blob 記憶體讀取或下載 Blob,包括其使用者定義的元數據和系統屬性。 |
Get Blob Properties | 區塊、附加和分頁 Blob | 傳回 Blob 上的所有系統屬性和使用者定義的中繼資料。 |
設定 Blob 屬性 | 區塊、附加和分頁 Blob | 根據現有 Blob 的定義設定系統屬性。 |
設定 Blob 到期 | 區塊 Blob | 設定現有 Blob 的到期時間。 |
取得 Blob 中繼資料 | 區塊、附加和分頁 Blob | 擷取現有 Blob 或快照集所有的使用者定義中繼資料。 |
設定 Blob 中繼資料 | 區塊、附加和分頁 Blob | 設定現有 Blob 的使用者定義中繼資料。 |
取得 Blob 標記 | 區塊、附加和分頁 Blob | 擷取現有 Blob 的使用者定義標記。 |
設定 Blob 標記 | 區塊、附加和分頁 Blob | 設定形成次要索引之現有 Blob 的使用者定義標籤。 |
依標籤尋找 Blob | 區塊、附加和分頁 Blob | 依使用者定義標記 清單 Blob。 |
刪除 Blob | 區塊、附加和分頁 Blob | 將 Blob 標示為刪除。 |
取消刪除 Blob | 區塊、附加和分頁 Blob | 還原虛刪除 Blob 的內容和元數據,或所有相關聯的虛刪除快照集。 |
租用 Blob | 區塊、附加和分頁 Blob | 建立及管理寫入和刪除作業的鎖定。 若要刪除或寫入鎖定的 Blob,用戶端必須提供租用識別碼。 |
快照 Blob | 區塊、附加和分頁 Blob | 建立 Blob 的唯讀快照集。 |
複製 Blob | 區塊、附加和分頁 Blob | 將來源 Blob 複製到此儲存體帳戶中的目的地 Blob,或其他儲存體帳戶中。 |
中止複製 Blob | 區塊、附加和分頁 Blob | 停止擱置 Copy Blob 的作業,並離開長度為零和完整元數據的目的地 Blob。 |
放置區塊 | 僅限區塊 blob | 建立要認可作為區塊 Blob 一部分的新區塊。 |
從 URL 放置區塊 | 僅限區塊 blob | 建立新的區塊,以作為從URL讀取內容的區塊 Blob 的一部分認可。 |
放置區塊清單 | 僅限區塊 blob | 藉由指定包含區塊 Blob 的區塊集識別碼來認可 Blob。 |
取得區塊清單 | 僅限區塊 blob | 擷取已上傳做為區塊 Blob 一部分的區塊清單。 |
查詢 Blob 內容 | 僅限區塊 blob | 在 Blob 的內容上套用簡單的 結構化查詢語言 (SQL) (SQL) 語句,並只傳回查詢的數據子集。 |
Set Blob Tier | 區塊和分頁 Blob | 設定 Blob 的階層。 |
放置頁面 | 僅限分頁 Blob | 將分頁範圍寫入分頁 Blob。 |
取得頁面範圍 (機器翻譯) | 僅限分頁 Blob | 針對分頁 Blob 或分頁 Blob 的快照集,傳回有效的分頁範圍清單。 |
機器翻譯 | 僅限分頁 Blob | 將來源分頁 Blob 的快照集複製到目的地分頁 Blob。 只會傳輸差異變更。 |
附加區塊 | 僅附加 Blob | 將數據區塊寫入附加 Blob 的結尾。 |