共用方式為


設定和擷取 Blob 服務資源的屬性和中繼資料

容器和 Blob 支援自訂中繼資料,以 HTTP 標頭表示。 中繼資料標頭可以設定於用來建立新容器或 Blob 資源的要求上,或是設定於用來在現有資源中明確建立屬性的要求上。

本主題包含下列子主題:

中繼資料標頭格式

中繼資料上的作業

容器和 Blob 的標準 HTTP 屬性

Blob 也支援標記,這是 Blob 服務自動編制索引的特殊自訂元資料類型。 如需詳細資訊,請參閱使用 Blob 索引管理及尋找Azure Blob 儲存體上的資料

中繼資料標頭格式

中繼資料標頭是名稱/值組。 標頭的格式如下:

x-ms-meta-name:string-value  

從 2009-09-19 版開始,中繼資料名稱必須遵守 C# 識別碼的命名規則。

名稱不區分大小寫。 請注意,中繼資料名稱會保留其建立時的大小寫,但在設定或讀取時並不區分大小寫。 如果針對單一資源提交兩個以上的同名中繼資料標頭,Blob 服務會傳回狀態碼 400 (不正確的要求)。

元数据由名称/值对组成。 所有元数据对的总大小上限为 8 KB。

中繼資料名稱/值組是有效的 HTTP 標頭,所以需遵守控管 HTTP 標頭的所有限制。

中繼資料上的作業

Blob 或容器資源上的中繼資料可以直接擷取或設定,而不會傳回或更改資源的內容。

請注意,中繼資料值必須完整讀取或寫入,不支援部分更新。 在資源上設定中繼資料會覆寫該資源的任何現有中繼資料值。

擷取屬性及中繼資料

GET 和 HEAD 作業都會擷取指定容器或 Blob 的中繼資料標頭。 HEAD 作業只會傳回標頭;它不會傳迴響應本文。

在容器上擷取中繼資料標頭的 URI 語法如下:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container  

在 Blob 上擷取中繼資料標頭的 URI 語法如下:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

設定中繼資料標頭

PUT 作業會在指定的容器或 Blob 上設定中繼資料標頭,覆寫資源上的任何現有中繼資料。 呼叫 PUT 時,若要求上沒有任何標頭,將會清除資源上的所有現有中繼資料。

在容器上設定中繼資料標頭的 URI 語法如下:

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container  

在 Blob 上設定中繼資料標頭的 URI 語法如下:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata  

容器和 Blob 的標準 HTTP 屬性

容器和 Blob 也支援特定標準 HTTP 屬性。 屬性和中繼資料都會以標準 HTTP 標頭表示,其間的差異在於標頭的命名。 中繼資料標頭會以標頭前置詞 x-ms-meta- 加上自訂名稱將其命名。 屬性標頭使用標準 HTTP 標頭名稱,如 HTTP/1.1 通訊協定規格的標頭欄位定義第 14 節所指定。

容器支援的標準 HTTP 標頭包括:

  • ETag

  • Last-Modified

Blob 支援的標準 HTTP 標頭包括:

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

  • Origin

  • Range

另請參閱

建立容器
取得容器屬性
設定容器中繼資料
放置 Blob
複製 Blob
Get Blob Properties
取得 Blob 中繼資料
設定 Blob 中繼資料
Blob 服務概念
使用 Blob 索引來管理和尋找 Azure Blob 儲存體上的資料