設定佇列中繼資料

Set Queue Metadata 作業為指定的佇列設定使用者定義的中繼資料。 中繼資料與佇列產生關聯的結果為名稱/值組。

要求

您可以依照下列方式建構 Set Queue Metadata 要求。 建議您使用 HTTPS。

方法	要求 URI	HTTP 版本
PUT	https://myaccount.queue.core.windows.net/myqueue?comp=metadata	HTTP/1.1

模擬儲存體服務要求

當您對模擬的儲存體服務提出要求時，請將模擬器主機名稱和佇列服務埠指定為 127.0.0.1:10001 ，後面接著模擬的儲存體帳戶名稱：

方法	要求 URI	HTTP 版本
PUT	http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata	HTTP/1.1

如需詳細資訊，請參閱使用 Azure 模擬器進行本機 Azure 儲存體開發。

URI 參數

您可以在要求 URI 上指定下列其他參數：

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

要求標頭

下表說明必要的和選擇性要求標頭：

要求標頭	描述
Authorization	必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
Date 或 x-ms-date	必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
x-ms-version	選擇性。 指定用於這個要求的作業版本。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。
x-ms-meta-name:string-value	選擇性。 做為中繼資料並與佇列相關聯的名稱/值組。 每次呼叫這項作業都會取代所有附加至佇列的現有中繼資料。 若要從佇列中移除所有中繼資料，請呼叫這項作業並且不使用中繼資料標頭。 注意：自 2009-09-19 版起，中繼資料名稱必須遵守 C# 識別碼的命名規則。
x-ms-client-request-id	選擇性。 提供用戶端產生的不透明值，其中包含 1-kibibyte (KiB) 設定記錄時記錄在記錄中的字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器收到的要求相互關聯。 如需詳細資訊，請參閱 監視 Azure 佇列儲存體。

要求本文

無。

範例要求

Request Syntax:  
PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT  
x-ms-meta-meta-sample1: sample1  
x-ms-meta-meta-sample2: sample2  
Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=  

回應

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

狀態碼

成功的作業會傳回狀態碼 204 (沒有內容)。

如需狀態碼的詳細資訊，請參閱 狀態和錯誤碼。

回應標頭

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

回應標頭	描述
x-ms-request-id	可唯一識別已提出的要求，並可用來對要求進行疑難排解。 如需詳細資訊，請參閱 針對 API 作業進行疑難排解。
x-ms-version	指出用來執行要求的佇列服務版本。 針對針對 2009-09-19 版和更新版本提出的要求，會傳回此標頭。
Date	服務所產生的 UTC 日期/時間值，表示起始回應的時間。
x-ms-client-request-id	此標頭可用來針對要求和對應的回應進行疑難排解。 如果此標頭存在於要求中，則此標頭的值等於標頭的值 x-ms-client-request-id ，且值不包含超過 1，024 個可見的 ASCII 字元。 x-ms-client-request-id如果要求中沒有標頭，則不會出現在回應中。

回應本文

無。

授權

只有帳戶擁有者可呼叫這項作業。

備註

若要刪除佇列中繼資料，請呼叫 Set Queue Metadata 並且不指定任何中繼資料標頭。

另請參閱

佇列服務錯誤碼
授權對 Azure 儲存體的要求
狀態和錯誤碼