附加 Blob 密封

附加 Blob 密封的目的是讓使用者和應用程式密封附加 blob,並將它們標示為唯讀。 本檔概述此功能的建議 REST API 規格。

帳戶擁有者以及具有具有寫入權限的共用存取簽章的任何人,都可以執行這項作業來存取 blob。

要求

Append Blob Seal 要求的建構如下。 建議使用 HTTPS。 請以您的儲存體帳戶名稱取代 myaccount

PUT 方法要求 URI HTTP 版本
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=seal HTTP/1.1

標題

附加 Blob 密封會傳回常見的 API 標頭、ETag/LMT (上次修改時間) 、x 毫秒-要求識別碼、x 毫秒-版本、內容長度和日期。 AppendBlobSeal 不會變更 ETag/LMT。

回應標頭 說明
x-ms-blob-密封 true/false 選擇性。 預設為 False。 如果 blob 是密封的,則在密封 blob 以及取得 blob 的屬性時,此標頭會包含在回應中。 應該會出現在 GetBlob、GetBlobProperties、AppendBlobSeal、ListBlobs for append blob 中。

查詢參數

沒有其他 URI 參數。

要求本文

無。

回應

回應包括 HTTP 狀態碼和回應標頭清單。

狀態碼

200 (成功) ,blob 已密封;呼叫具有等冪性,而且如果 blob 已密封,則會成功

409 (在現有的分頁 blob 或區塊 blob 上呼叫 InvalidBlobType)

404 (在不存在的 blob 上呼叫 BlobNotFound)

備註

如果附加 blob 有租用期,將需要租用識別碼來密封 blob。

Blob 密封之後,屬性、blob 索引標記和中繼資料仍然可以更新。 虛刪除密封的 blob 將會保留密封的狀態。 密封的 blob 可以覆寫。

取得密封 blob 的快照集將會包含密封旗標。 如果新版本中已經有快照集,我們 將會 傳回屬性。

複製密封的 blob 時,預設會傳播密封旗標。 將會公開標頭,以允許覆寫旗標。

新的 XML 元素會加入至名為 Sealed 的 ListBlob 回應,其值可以是 true 或 false。

在已密封的 blob 上呼叫 AppendBlock,會傳回下表所列的錯誤碼。 這適用于較舊版本的 API。

錯誤碼 HTTP 狀態碼 使用者訊息
BlobIsSealed 衝突 (409) 指定的 blob 是密封的,而且無法修改其內容,除非在刪除後重新建立 blob。

在已密封的附加 blob 上呼叫附加 blob 密封會導致狀態碼200成功但無法運作。

另請參閱

Blob 服務錯誤碼