匯出 (0) 列印
全部展開

放置訊息

更新日期: 2014年9月

Put Message 作業可將新訊息加入到訊息佇列的後端。您也可以指定可見度逾時,在可見度逾時終止前隱藏訊息。訊息必須使用 UTF-8 編碼格式,才可包含在 XML 要求中。在 2011-08-18 及更新版本中,此編碼訊息的大小上限為 64 KB;在舊版中,其大小上限則為 8 KB。

Put Message 要求的建構如下。建議使用 HTTPS。以您的儲存體帳戶名稱取代 myaccount,並以您的佇列名稱取代 myqueue

 

方法 要求 URI HTTP 版本

POST

https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

此作業及選擇性 visibilitytimeout 參數受到 SDK 1.6 和更新版本的支援。

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

 

方法 要求 URI HTTP 版本

POST

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

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

 

參數 描述

visibilitytimeout=<int=seconds>

選擇性。如果為指定,則必須使用 2011-08-18 或更新版本的 x-ms-version 要求。如果不指定,預設值為 0。指定相對於伺服器時間的新可見度逾時值 (以秒為單位)。此新值必須大於或等於 0,而且不得超過 7 天。訊息的可見度逾時不得設定晚於到期時間的值。visibilitytimeout 值應設定為小於存留時間值。

messagettl=<int-seconds>

選擇性。指定訊息之存留時間的間隔 (以秒為單位)。允許的最大存留時間為 7 天。如果省略此參數,預設存留時間為 7 天。

timeout

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

下表描述必要的和選用的要求標頭。

 

要求標頭 描述

Authorization

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

Date or x-ms-date

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

x-ms-version

選擇性。指定用於這個要求的作業版本。如需詳細資訊,請參閱為 Windows Azure 中的 Blob、佇列和表格服務進行版本設定

x-ms-client-request-id

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

要求主體包含下列 XML 格式中的訊息資料。請注意,訊息內容必須使用 UTF-8 編碼格式。

<QueueMessage>
    <MessageText>message-content</MessageText>
</QueueMessage>

Request:
POST https://myaccount.queue.core.windows.net/messages?visibilitytimeout=30&timeout=30 HTTP/1.1

Headers:
x-ms-version: 2011-08-18
x-ms-date: Tue, 30 Aug 2011 01:03:21 GMT
Authorization: SharedKey myaccount:sr8rIheJmCd6npMSx7DfAY3L//V3uWvSXOzUBCV9wnk=
Content-Length: 100

Body:
<QueueMessage>
<MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText>
</QueueMessage>

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

成功的作業會傳回狀態碼「201 (已建立)」。

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

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

 

要求標頭 描述

x-ms-request-id

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

x-ms-version

指出用於執行要求的佇列服務版本。對 2009-09-19 及更新版本提出要求會傳回此標頭。

Date

服務產生的 UTC 日期/時間值,可指出啟動回應的時間。

無。

帳戶擁有者及使用共用存取簽章並有權執行這項作業的任何人,都可以執行這項作業。

選擇性可見度逾時指定隱藏訊息的時間。逾時終止之後,會顯示訊息。如果未指定可見度逾時,則會使用預設值 0。

選擇性訊息存留時間指定訊息保留在佇列中的時間。存留時間期限到期時,將會從佇列中刪除訊息。

訊息必須使用 UTF-8 編碼格式,才可包含在 XML 要求中。若要在訊息中加入標記,訊息內容必須是 XML 逸出格式或 Base64 編碼格式。訊息中不是逸出格式或編碼格式的任何 XML 標記,都會在訊息加入佇列之前被移除。

如果訊息太大,服務會傳回狀態碼 400 (不正確的要求)。

顯示:
© 2015 Microsoft