銷售: 1-800-867-1380

放置訊息 (REST API)

更新日期: 2013年7月

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

如需詳細資訊,請參閱<About Development Storage>。

URI 參數

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

 

參數 說明

visibilitytimeout=<int=seconds>

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

messagettl=<int-seconds>

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

timeout

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

要求標頭

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

 

要求標頭 說明

Authorization

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

Date or x-ms-date

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

x-ms-version

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

x-ms-client-request-id

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

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

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

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2014 Microsoft