共用方式為

刪除 Azure 記憶體 (訊息)

  • 發行項

作業 Delete Message 會從佇列中刪除指定的訊息。

要求

您可以建構 Delete Message 要求，如下所示。 建議使用 HTTPS。

方法 要求 URI HTTP 版本
DELETE https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value HTTP/1.1

將 取代為您的記憶體帳戶名稱、myqueue佇列名稱，並將 string-value 取代myaccount為已取得的快顯收據值，以便刪除訊息。

模擬記憶體服務 URI

當您對模擬記憶體服務提出要求時，請將模擬器主機名和 Azure 佇列記憶體埠指定為 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 參數

要求 URI 支援下列參數。

參數 描述
popreceipt 必要。 從先前呼叫 取得訊息 或 更新訊息 作業傳回的有效快顯收據值。
timeout 選擇性。 timeout 參數以秒為單位。 如需詳細資訊，請參閱 設定佇列記憶體作業的逾時。

要求標頭

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

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
Date 或 x-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊，請參閱授權對 Azure 儲存體提出要求。
x-ms-version 選擇性。 指定用於這個要求的作業版本。 如需詳細資訊，請參閱 Azure 儲存體服務的版本。
x-ms-client-request-id 選擇性。 提供客戶端產生的不透明值，其中包含設定記錄時記錄的 1 kibibyte (KiB) 字元限制。 強烈建議您使用此標頭，將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊，請參閱 監視 Azure 佇列記憶體。

要求本文

無。

回應

回應包括 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如果要求中沒有標頭，此標頭將不會出現在回應中。

回應本文

無。

授權

帳戶擁有者可以執行這項作業。 此外，具有共用存取簽章且有權執行這項作業的任何人都可以執行此作業。

備註

當您成功刪除郵件時，系統會立即將其標示為要刪除，而且無法再存取。

當用戶端使用 取得訊息 作業擷取訊息之後，客戶端應該會處理和刪除訊息。 若要刪除訊息，您必須具有 Get Messages 作業的回應主體中所傳回的兩個資料項目：

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

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

訊息識別碼是從之前的 Get Messages 作業所傳回。 Pop receipt 是由最近的 Get Messages 或 Update Message 作業所傳回。 Delete Message若要讓作業成功，要求上指定的快顯收據必須符合 或 Update Message 作業傳回的Get Messages快顯收據。

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

  • 訊息到期。

  • 郵件會使用從 Get Messages 或 Update Message收到的最後一個快顯收據來刪除。

  • 不可見逾時會過期，而且訊息會由 Get Messages 要求清除佇列。 當不可見逾時過期時，訊息會再次顯示。 如果由另一個 Get Messages 要求擷取，則傳回的快顯收據可用來刪除或更新訊息。

  • 訊息會以新的可見度逾時更新。 更新訊息時，會傳回新的快顯收據。

如果找不到具有相符快顯收據的訊息，服務會傳回錯誤碼 404 (找不到) 。 此錯誤發生在先前列出的快顯收據不再有效的情況下。

另請參閱

授權對 Azure 記憶體的要求
狀態和錯誤碼
佇列記憶體錯誤碼