設定 Blob 屬性

Set Blob Properties 作業會在 Blob 上設定系統屬性。

要求

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

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

模擬儲存體服務 URI

對模擬儲存體服務提出要求時,請將模擬器主機名稱和 Blob 服務通訊埠指定為 127.0.0.1:10000,後面接著模擬儲存體帳戶名稱:

PUT 方法要求 URI HTTP 版本
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

如需詳細資訊,請參閱使用Azure 儲存體 Emulator進行開發和測試

URI 參數

您可以在要求的 URI 中指定下列其他參數。

參數 描述
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊,請參閱 設定 Blob 服務作業的逾時

要求標頭 (所有 Blob 類型)

下表描述所有 Blob 類型的必要和選擇性要求標頭。

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊,請參閱授權要求Azure 儲存體
Datex-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊,請參閱授權要求Azure 儲存體
x-ms-version 所有已授權要求都需要。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱Azure 儲存體 Services 的版本設定
x-ms-blob-cache-control 選擇性。 修改 Blob 的快取控制字串。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。 取得 Blob 屬性 的後續呼叫將不會傳回這個屬性,除非它再次明確設定在 Blob 上。
x-ms-blob-content-type 選擇性。 設定 Blob 的內容類型。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。 取得 Blob 屬性 的後續呼叫將不會傳回這個屬性,除非它再次明確設定在 Blob 上。
x-ms-blob-content-md5 選擇性。 設定 Blob 的 MD5 雜湊。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。 取得 Blob 屬性 的後續呼叫將不會傳回這個屬性,除非它再次明確設定在 Blob 上。
x-ms-blob-content-encoding 選擇性。 設定 Blob 的內容編碼。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。 取得 Blob 屬性 的後續呼叫將不會傳回這個屬性,除非它再次明確設定在 Blob 上。
x-ms-blob-content-language 選擇性。 設定 Blob 的內容語言。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。 取得 Blob 屬性 的後續呼叫將不會傳回這個屬性,除非它再次明確設定在 Blob 上。
x-ms-lease-id:<ID> 如果 Blob 具有作用中租用,則為必要項目。 若要在具有作用中租用的 Blob 執行這項作業,請指定此標頭的有效租用識別碼。
x-ms-client-request-id 選擇性。 提供用戶端產生的不透明值,其中包含啟用儲存體分析記錄時,分析記錄中記錄的 1 KiB 字元限制。 強烈建議使用此標頭來將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊,請參閱關於儲存體分析記錄Azure 記錄:使用記錄來追蹤儲存體要求
x-ms-blob-content-disposition 選擇性。 設定 Blob 的 Content-Disposition 標頭。 適用於 2013-08-15 和更新版本。

Content-Disposition 回應標頭欄位會傳遞如何處理回應裝載的其他資訊,也可用來附加其他中繼資料。 例如,如果設為 attachment,它會指出使用者代理程式不該顯示回應,而要顯示具有檔案名稱而不是指定之 Blob 名稱的 [另存新檔] 對話方塊。

取得 Blob取得 Blob 屬性作業的 content-disposition 回應包含 標頭。
Origin 選擇性。 指定發出要求的來源。 此標頭的顯示會導致在回應上跨原始資源共用標頭。 如需詳細資訊,請參閱 儲存體 服務的 CORS 支援

唯有在符合指定條件的情況下,此作業也支援使用條件式標頭,設定 Blob 屬性。 如需詳細資訊,請參閱指定 Blob 服務作業的條件式標頭

要求標頭 (僅限分頁 Blob)

下表描述的要求標頭只適用於分頁 Blob 上的作業。

要求標頭 描述
x-ms-blob-content-length: byte value 選擇性。 將分頁 Blob 調整為指定的大小。 如果指定的值小於 Blob 目前的大小,則會清除大於指定值的所有分頁。

此屬性無法用來變更區塊 Blob 或附加 Blob 的大小。 設定區塊 Blob 或附加 Blob 的這個屬性會傳回狀態碼 400 (不正確的要求) 。
x-ms-sequence-number-action: {max, update, increment} 選擇性項目,但是如果為要求設定 x-ms-blob-sequence-number 標頭,則為必要項目。 此屬性只會套用至分頁 Blob。

此屬性會指出服務應如何修改 Blob 的序號。 請為此屬性指定下列其中一個選項:

- max:將序號設定為要求中包含的值,以及目前為 Blob 儲存的值。
- update:將序號設定為要求中包含的值。
- increment:將序號的值遞增 1。 如果指定此選項,請勿包含 x-ms-blob-sequence-number header,這麼做會傳回狀態碼 400 (不正確的要求)。
x-ms-blob-sequence-number: <num> 選擇性項目,但是如果 x-ms-sequence-number-action 屬性設為 maxupdate,則為必要項目。 此屬性只會套用至分頁 Blob。

此屬性會設定 Blob 的序號。 序號是使用者控制的屬性,可用來追蹤要求和管理並行問題。 如需詳細資訊,請參閱 放置頁面 作業。

將此屬性與 x-ms-sequence-number-action 一起搭配使用,可將 Blob 的序號更新為指定的值,或是大於要求指定的值或目前隨 Blob 儲存的值。 如果 x-ms-sequence-number-action 設為 increment,則不應指定此標頭,在此情況下,服務會自動以一為單位遞增序號。

若要將序號設為您選擇的值,則必須將此屬性與 x-ms-sequence-number-action 一起指定在要求中。

要求標頭 (客戶提供的加密金鑰)

從 2019-02-02 版開始,可以在要求上指定下列標頭,以使用客戶提供的金鑰加密 Blob。 使用客戶提供的金鑰進行加密 (,而對應的標頭集) 是選擇性的。 如果 Blob 先前已使用客戶提供的金鑰加密,則必須在要求中包含這些標頭,才能順利完成寫入作業。

要求標頭 描述
x-ms-encryption-key 必要。 Base64 編碼的 AES-256 加密金鑰。
x-ms-encryption-key-sha256 必要。 加密金鑰的 Base64 編碼 SHA256 雜湊。
x-ms-encryption-algorithm: AES256 必要。 指定要用於加密的演算法。 此標頭的值必須設定為 AES256

要求本文

無。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊,請參閱 狀態和錯誤碼

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格

語法 描述
ETag ETag 包含的值可讓您依條件執行作業。 如需詳細資訊 ,請參閱指定 Blob 服務作業的條件標頭 。 如果要求版本為 2011-08-18 或更新版本,ETag 值會加上引號。
Last-Modified 上次修改 Blob 的日期/時間。 日期格式會依照 RFC 1123。 如需詳細資訊,請參閱 標頭中Date-Time值的表示

Blob 上的任何寫入作業 (包括 Blob 的中繼資料或屬性更新) 都會變更 Blob 的上次修改時間。
x-ms-blob-sequence-number 如果 Blob 是分頁 Blob,則會將 Blob 目前的序號與此標頭一起傳回。
x-ms-request-id 此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。 如需詳細資訊,請參閱 針對 API 作業進行疑難排解
x-ms-version 指出用於執行要求的 Blob 服務版本。 對 2009-09-19 及更新版本提出要求會傳回此標頭。
Date 服務產生的 UTC 日期/時間值,可指出啟動回應的時間。
Access-Control-Allow-Origin 如果要求包含 Origin 標頭,並啟用 CORS 及比對規則,則傳回此標頭。 此標頭會在相符時傳回原始要求標頭的值。
Access-Control-Expose-Headers 如果要求包含 Origin 標頭,並啟用 CORS 及比對規則,則傳回此標頭。 傳回向要求的用戶端或簽發者公開的回應標頭清單。
Access-Control-Allow-Credentials 如果要求包含 Origin 標頭,並啟用 CORS 及不允許所有來源的比對規則,則傳回此標頭。 這個標頭會設定為 true。
x-ms-client-request-id 此標頭可用來針對要求和對應的回應進行疑難排解。 如果此標頭存在於要求中,且此值最多為 1024 個可見的 ASCII 字元,則此標頭的值等於標頭的值 x-ms-client-request-idx-ms-client-request-id如果要求中沒有標頭,此標頭將不會出現在回應中。

回應本文

無。

授權

只有帳戶擁有者以及擁有共用存取簽章的任何人才能呼叫此作業,且簽章需有此 Blob 或其容器的寫入權限。

備註

更新 Blob 屬性的語意如下:

  • 要求必須符合下列條件之一,才能更新分頁 Blob 的序號:

    • 要求將 x-ms-sequence-number-action 設為 maxupdate,並且為 x-ms-blob-sequence-number 標頭指定一個值。

    • 要求將 x-ms-sequence-number-action 設為 increment,表示服務應以一為單位遞增序號。

  • 要求必須為 x-ms-content-length 標頭指定一個值,才能修改分頁 Blob 的大小。

  • 若要變更進階儲存體帳戶中的分頁 Blob 大小,新大小不得超過現有層所允許的內容長度。 重設 Blob 大小之前,請先呼叫 設定 Blob 層 。 如需階層和允許的內容長度清單,請參閱VM 的高效能進階儲存體和受控磁片

  • 如果要求只設定 x-ms-blob-sequence-number 及/或 x-ms-content-length,而沒有其他屬性,則不會修改 Blob 的其他屬性。

  • 如果在要求中設定下列一個或多個屬性,這些屬性會全部一起設定。 至少已設定下列其中一個屬性時,如果沒有為給定的屬性提供一個值,則會為 Blob 清除該屬性。

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

注意

請注意,您可以針對共用存取簽章,藉由指定查詢參數為共用存取簽章的一部分,覆寫為 Blob 儲存的某些屬性。 這些屬性包括 cache-controlcontent-typecontent-encodingcontent-languagecontent-disposition 屬性。 如需詳細資訊,請參閱 建立服務 SAS

另請參閱

授權要求Azure 儲存體
狀態和錯誤碼