附加 Blob 密封

作業的目的是 Append Blob Seal 允許使用者和應用程式密封附加 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

標題

Append Blob Seal會傳回常見的 API 標頭, ETag/LMT (上次修改的時間) 、、 x-ms-versionx-ms-request-idcontent-length 、 和 。 Date Append Blob Seal不會變更 ETag/LMT

回應標頭 ReplTest1 說明
x-ms-blob-sealed true/false 選擇性。 預設為 False。 如果 Blob 已密封,當您密封並取得 Blob 的屬性時,回應中會包含此標頭。 此標頭應該會出現在 、 GetBlobPropertiesAppendBlobSealListBlobsGetBlob ,用於附加 Blob。

查詢參數

沒有其他 URI 參數。

要求本文

無。

回應

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

狀態碼

您可能會收到下列任何狀態碼:

  • 200 (成功) :Blob 已密封。 呼叫是等冪的,如果 Blob 已經密封,就會成功。

  • 409 (InvalidBlobType) :如果呼叫位於現有的分頁 Blob 或區塊 Blob 上,服務會傳回此狀態碼。

  • 404 (BlobNotFound) :如果呼叫位於不存在的 Blob 上,服務會傳回此狀態碼。

備註

如果附加 Blob 有租用,您需要租用識別碼來密封 Blob。

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

如果您擷取密封 Blob 的快照集,快照集會包含密封旗標。 針對新版本中的現有快照集,Microsoft 會傳回 屬性。

當您複製密封 Blob 時,預設會傳播密封旗標。 標頭會公開,允許覆寫旗標。

新的 XML 專案將會新增至 ListBlob 名為 的 Sealed 回應。 這個值可以是 truefalse

如果您在已密封的 Blob 上呼叫 AppendBlock ,服務會傳回下表所示的錯誤訊息。 這適用于舊版的 API。

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

如果您在已經密封的附加 Blob 上呼叫 Append Blob Seal ,您只會看到狀態碼 200 (Success) 。

另請參閱

Azure Blob 儲存體錯誤碼