Partager via


Déverrouillage de message

Déverrouille un message pour qu'il soit traité par d'autres récepteurs sur un abonnement spécifié. Cette opération supprime l'objet de verrouillage, ce qui entraîne le déverrouillage du message. Avant d'appeler cette opération, un récepteur doit d'abord verrouiller le message.

Requête

Méthode URI de demande Version HTTP
PUT http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

or

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

Paramètres URI

L'URI est indiqué dans l'en-tête Location de l'aperçu du message, ou vous pouvez le générer à partir des éléments décrits dans le tableau suivant.

Paramètre Description
messageId ID du message à déverrouiller tel que retourné par BrokerProperties{MessageId} l’opération Aperçu du message .
sequence-number Numéro de séquence du message à déverrouiller tel que retourné par BrokerProperties{SequenceNumber} l’opération Aperçu du message .
lockToken Jeton du verrou du message à déverrouiller tel que retourné par l’opération Aperçu du message dans BrokerProperties{LockToken}.

En-têtes de requête

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.

En-tête de requête Description
Autorisation Spécifiez l'une des valeurs suivantes :

Corps de la requête

Aucun.

response

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et le corps de réponse.

Codes de réponse

Code Description
200 Message correctement déverrouillé.
401 Échec de l'autorisation.
404 Aucun message n’a été trouvé avec le spécifié MessageId ou LockToken.
410 La file d'attente ou l'abonnement spécifié n'existe pas.
500 Erreur interne.

Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.

En-têtes de réponse

En-tête de réponse Description
Content-Type Défini sur application/atom+xml;type=entry;charset=utf-8.

Corps de la réponse

Aucun.

Exemple

La requête HTTP suivante déverrouille un message :

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  

Service Bus retourne la réponse suivante :

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  

Voir aussi

Exemple de client HTTP Service Bus