將訊息解除鎖定

  • 發行項

在指定的訂閱上解除鎖定訊息，以便由其他接收者進行處理。 此作業會刪除鎖定物件，進而導致將訊息解除鎖定。 在呼叫此作業前，接收者必須先鎖定訊息。

要求

方法 要求 URI HTTP 版本
PUT 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 要解除鎖定之訊息的識別碼，如查看訊息作業所 BrokerProperties{MessageId} 傳回。
sequence-number 要解除鎖定之訊息的序號，如查看訊息作業所 BrokerProperties{SequenceNumber} 傳回。
lockToken 要解除鎖定之訊息的權杖，如 中的 BrokerProperties{LockToken}查看訊息作業所傳回。

要求標頭

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

要求標頭 描述
授權 請指定下列其中一個選項：
  • Azure Active Directory (Azure AD) JSON Web 權杖 (JWT) 權杖。
    範例： Authorization: Bearer <Azure AD JWT token>.
    如需產生 Azure AD 權杖的資訊，請參閱 從應用程式進行驗證。
  • 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 要求會解除鎖定訊息：

PUT 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 用戶端範例