匯出 (0) 列印
全部展開
本主題尚未接受評分 - 為這個主題評分

設定 Blob 屬性 (REST 應用程式開發介面)

更新日期: 2014年1月

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

如需詳細資訊,請參閱 About Development Storage儲存體模擬器和 Windows Azure 儲存體服務之間的差異

URI 參數

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

 

參數 說明

timeout

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

要求標頭 (區塊和分頁 Blob)

下表描述在區塊 Blob 和分頁 Blob 上執行作業的必要和選擇性要求標頭。

 

要求標頭 說明

Authorization

必要項。指定驗證配置、帳戶名稱及簽章。如需詳細資訊,請參閱<Windows Azure 儲存體服務的驗證>。

Datex-ms-date

必要項。指定要求的國際標準時間 (UTC)。如需詳細資訊,請參閱<Windows Azure 儲存體服務的驗證>。

x-ms-version

所有已驗證要求的必要項。指定用於這個要求的作業版本。如需詳細資訊,請參閱<為 Windows Azure 中的 Blob、佇列和表格服務進行版本設定>。

x-ms-blob-cache-control

選擇性。修改 Blob 的快取控制字串。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。除非在 Blob 上明確地重新設定,否則後續的 取得 Blob 屬性 (REST 應用程式開發介面) 呼叫將不會傳回此屬性。

x-ms-blob-content-type

選擇性。設定 Blob 的內容類型。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。除非在 Blob 上明確地重新設定,否則後續的 取得 Blob 屬性 (REST 應用程式開發介面) 呼叫將不會傳回此屬性。

x-ms-blob-content-md5

選擇性。設定 Blob 的 MD5 雜湊。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。除非在 Blob 上明確地重新設定,否則後續的 取得 Blob 屬性 (REST 應用程式開發介面) 呼叫將不會傳回此屬性。

x-ms-blob-content-encoding

選擇性。設定 Blob 的內容編碼。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。除非在 Blob 上明確地重新設定,否則後續的 取得 Blob 屬性 (REST 應用程式開發介面) 呼叫將不會傳回此屬性。

x-ms-blob-content-language

選擇性。設定 Blob 的內容語言。

如果要求中未指定此屬性,則會清除 Blob 的這個屬性。除非在 Blob 上明確地重新設定,否則後續的 取得 Blob 屬性 (REST 應用程式開發介面) 呼叫將不會傳回此屬性。

x-ms-lease-id:<ID>

如果 Blob 具有作用中租用,則為必要項。若要在具有作用中租用的 Blob 執行這項作業,請指定此標頭的有效租用識別碼。

x-ms-client-request-id

選擇性。提供由用戶端產生的不透明值 (具有 1 KB 的字元限制),當儲存體分析記錄為啟用狀態時,此值會記錄在分析記錄檔中。如果是和伺服器所接收的要求相關之用戶端活動,則強烈建議您使用此標頭。如需詳細資訊,請參閱<關於儲存體分析記錄>和<Windows Azure 儲存體記錄:使用記錄檔追蹤儲存體要求>。

x-ms-blob-content-disposition

選擇性。設定 Blob 的 Content-Disposition 標頭。適用於 2013-08-15 和更新版本。

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

取得 Blob (REST 應用程式開發介面)取得 Blob 屬性 (REST 應用程式開發介面) 作業的回應包括 content-disposition 標頭。

Origin

選擇性。指定發出要求的來源。此標頭的顯示會導致在回應上跨原始資源共用標頭。如需詳細資訊,請參閱<跨原始資源共用 (CORS) 支援 Windows Azure 儲存體服務>。

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

要求標頭 (僅限分頁 Blob)

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

 

要求標頭 說明

x-ms-blob-content-length: byte value

選擇性。將分頁 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 的序號。序號是使用者控制的屬性,可用來追蹤要求和管理並行問題。如需詳細資訊,請參閱<放置分頁 (REST 應用程式開發介面)>作業。

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

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

要求主體

無。

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

狀態碼

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

如需狀態碼的資訊,請參閱<狀態和錯誤碼>。

回應標頭

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

 

語法 說明

ETag

ETag 包含的值可讓您依條件執行作業。如需詳細資訊,請參閱<指定 Blob 服務作業的條件式標頭>。如果要求版本為 2011-08-18 或更新版本,ETag 值會加上引號。

Last-Modified

上次修改 Blob 的日期/時間。日期格式會依照 RFC 1123。如需詳細資訊,請參閱<標頭中的日期/時間值表示方式>。

Blob 上的任何寫入作業 (包括 Blob 的中繼資料或屬性更新) 都會變更 Blob 的上次修改時間。

x-ms-blob-sequence-number

如果 Blob 是分頁 Blob,則會將 Blob 目前的序號與此標頭一起傳回。

x-ms-request-id

此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。如需詳細資訊,請參閱<對應用程式開發介面作業進行疑難排解>。

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。

回應主體

無。

只有帳戶擁有者以及擁有共用存取簽章的任何人才能呼叫此作業,且簽章需有此 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 的大小。

  • 如果要求只設定 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 屬性。如需詳細資訊,請參閱<建構共用存取簽章 URI (REST API)>。

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2014 Microsoft. 著作權所有,並保留一切權利。