銷售: 1-800-867-1380

刪除訊息

更新日期: 2015年4月

Delete Message 作業可刪除指定的訊息。

Delete Message 要求的建構如下。建議使用 HTTPS。請以您的儲存體帳戶名稱取代 myaccount,以您的佇列名稱取代 myqueue,並以針對所要刪除之訊息所取得的 pop receipt 值取代 string-value

 

方法 要求 URI HTTP 版本

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

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

 

方法 要求 URI HTTP 版本

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

要求 URI 支援下列參數。

 

參數 描述

popreceipt

必要項。從之前呼叫 取得訊息更新訊息 作業所傳回的有效 pop receipt 值。

timeout

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

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

 

要求標頭 描述

Authorization

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

Datex-ms-date

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

x-ms-version

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

x-ms-client-request-id

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

無。

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

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

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

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

 

要求標頭 描述

x-ms-request-id

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

x-ms-version

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

Date

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

無。

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

成功刪除訊息之後,此訊息會立即標示為刪除,且用戶端將無法再存取此訊息。當記憶體回收時,將會從佇列中移除此訊息。

用戶端使用 取得訊息 作業擷取訊息之後,應該可以處理及刪除訊息。若要刪除訊息,您必須具有 Get Messages 作業的回應主體中所傳回的兩個資料項目:

  • 訊息識別碼,此為可識別佇列中訊息的不透明 GUID 值。

  • 有效的 pop receipt,此為可指出已擷取訊息的不透明值。

訊息識別碼是從之前的 Get Messages 作業所傳回。Pop receipt 是由最近的 Get MessagesUpdate Message 作業所傳回。Delete Message 作業若要成功,要求中所指定的 pop receipt 必須符合 Get MessagesUpdate Message 作業所傳回的 pop receipt。

Pop receipt 會持續有效到發生下列其中一個事件為止:

  1. 訊息已過期。

  2. 使用從 Get MessagesUpdate Message 擷取的上一個 pop receipt 刪除的訊息。

  3. 已過了隱藏逾時時間,因此 Get Messages 要求已從佇列中清除訊息。過了隱藏逾時時間之後,將再次顯示訊息。如果是由另一個 Get Messages 要求擷取,傳回的 pop receipt 可用於刪除或更新訊息。

  4. 訊息已更新可見度逾時。更新訊息時,會傳回新的 pop receipt。

如果找不到含有相符 pop receipt 的訊息,服務會傳回錯誤碼 404 (找不到)。在上述 pop receipt 不再有效的情況下會發生此錯誤。

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