Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Afficher/verrouiller un message de la file d'attente (lecture non destructrice)

Récupère et verrouille atomiquement un message d’une file d’attente pour traitement. Le message est sûr de ne pas être livré à d'autres récepteurs (uniquement du même abonnement) durant la durée de verrouillage spécifiée dans la description de la file d'attente. Après expiration du verrouillage, le message sera disponible aux autres récepteurs. Afin de terminer le traitement du message, le récepteur doit émettre une commande de suppression avec l'ID de verrouillage reçu de cette opération. Pour abandonner le traitement du message et le déverrouiller pour les autres récepteurs, une commande de déverrouillage de message doit être émise, ou la durée de verrouillage peut expirer.

Cette opération doit être utilisée dans les applications qui nécessitent des assurances de livraison Au moins une fois. En supposant que le récepteur ne supprime pas le message avant la réussite du traitement, cela permettra de s'assurer qu'un autre récepteur pourra tenter le traitement après expiration de la durée de verrouillage.

 

Méthode URI de requête Version HTTP

POST

https://{espace de noms de service}.servicebus.Windows.net/{chemin d'accès à la file d'attente}/messages/head?timeout={secondes}

HTTP/1.1

Paramètres URI

Aucune.

En-têtes de requêtes

Le tableau suivant décrit les en-têtes de requêtes requises et facultatives.

 

En-tête de requête Description

Autorisation

Spécifie un jeton WRAPv0.9.7.2 contenant un SimpleWebToken acquis d'ACS. Défini sur WRAP access_token=”{swt}”.

Corps de la requête

Aucune.

La réponse inclut un code de statut HTTP et un ensemble d'en-têtes de réponse.

Codes de réponse

 

Code Description

201

Le message a été verrouillé avec succès pour le traitement et le verrou est créé.

204

Aucun message disponible dans le délai spécifié.

400

Délai non valide.

401

Échec de l'autorisation.

404

L'abonnement n'a jamais existé.

410

L'abonnement spécifié n'existe pas.

500

Erreur interne.

Pour plus d'informations sur les codes de statut, voir Codes de statut et codes d'erreur.

En-têtes de réponse

La réponse à cette opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard se conforment à la spécification du protocole HTTP/1.1.

 

En-tête de réponse Description

Emplacement

L'URI du message verrouillé. Cet URI est nécessaire pour déverrouiller ou supprimer le message.

BrokerProperties{LockToken}

L'ID de verrouillage pour le message verrouillé.

BrokerProperties{SequenceNumber}

Le numéro de séquence du message verrouillé.

Corps de la réponse

Le corps du message récupéré.

Ajouts de la communauté

Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft. Tous droits réservés.