刪除訊息

  • 發行項

此作業會完成鎖定訊息的處理，並從佇列或訂閱中予以刪除。 只有在成功處理先前鎖定的訊息之後才可呼叫此作業，以確保「至少一次」的傳送保證。

要求

方法 要求 URI HTTP 版本
DELETE http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

或

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

URI 參數

URI 提供在所查看訊息的 [位置] 標頭中，或者，您可以透過下表所述的部分來建構它。

參數 Description
messageId 預覽 Message 作業所傳回BrokerProperties{MessageId}的訊息標識碼。
sequence-number 要刪除之訊息的序號，如 預覽 訊息作業所BrokerProperties{SequenceNumber}傳回。
lockToken 中 預覽 訊息作業BrokerProperties{LockToken}所傳回之訊息鎖定的令牌。

要求標頭

下表描述必要的和選用的要求標頭。 除了列出的屬性以外，標頭還可包含自訂屬性。 請參閱範例。

要求標頭 描述
授權 指定下列其中一個權杖值：
  • Microsoft Entra ID JSON Web 令牌 (JWT) 令牌。
    範例： Authorization: Bearer <Azure AD JWT token>.
    如需產生 Microsoft Entra 令牌的資訊，請參閱取得 Microsoft Entra 令牌。
  • SAS 權杖。
    範例： Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    如需產生 SAS 令牌的資訊，請參閱 產生共用存取簽章令牌 和 產生 SAS 令牌。

要求本文

無。

回應

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

回應碼

程式碼 描述
200 已順利刪除訊息。
401 授權失敗。
404 找不到具有指定 MessageId 或 LockToken的訊息。
410 指定的佇列或訂用帳戶不存在。
500 內部錯誤。

如需狀態代碼的相關信息，請參閱 狀態和錯誤碼。

回應標頭

回應標頭 Description
Content-Type 設定為 application/atom+xml;type=entry;charset=utf-8。

回應本文

無。

範例

下列 HTTP 要求會刪除佇列中的訊息：

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

服務總線會傳回下列回應：

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

另請參閱

服務匯流排 HTTP 用戶端範例