Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Déverrouille un message pour le traitement 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 l’appel de l’opération, un récepteur doit d’abord verrouiller le message.
Demander
| Méthode | URI de requête | HTTP Version |
|---|---|---|
| METTRE | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}ou http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1 |
Paramètres d’URI
L’URI est fourni dans l’en-tête Location du message aperçu, ou vous pouvez le construire à partir des parties décrites dans le tableau suivant.
| Paramètre | Description |
|---|---|
messageId |
ID du message à déverrouiller tel qu’il est retourné dans BrokerProperties{MessageId} par l’opération message d’aperçu. |
sequence-number |
Numéro de séquence du message à déverrouiller tel qu’il est retourné dans BrokerProperties{SequenceNumber} par l’opération Aperçu du message. |
lockToken |
Jeton du verrou du message à déverrouiller, tel qu’il est retourné par l’opération Peek Message dans BrokerProperties{LockToken}. |
En-têtes de requête
Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.
| En-tête de requête | Description |
|---|---|
| Autorisation | Spécifiez l’une des valeurs suivantes :
|
Corps de la demande
Aucun.
Réponse
La réponse inclut un code d’état HTTP, un ensemble d’en-têtes de réponse et le corps de la réponse.
Codes de réponse
| Code | Description |
|---|---|
| 200 | Message déverrouillé avec succès. |
| 401 | Échec de l’autorisation. |
| 404 | Aucun message n’a été trouvé avec le MessageId ou LockTokenspécifié. |
| 410 | La file d’attente ou l’abonnement spécifié n’existe pas. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes d’état, consultez Status and Error Codes.
En-têtes de réponse
| En-tête de réponse | Description |
|---|---|
| Type de contenu | 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