共用方式為

更新並鎖定訊息

  • 發行項

對已鎖定的訊息更新鎖定。

要求

方法 要求 URI HTTP 版本
POST 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 內部錯誤。

如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。

回應標頭

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

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

回應本文

無。

範例

下列 HTTP 要求會對已鎖定的訊息更新鎖定：

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