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