Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Recevoir et supprimer le Message (lecture destructrice)

 

Cette opération permet de recevoir un message d'une file d'attente ou d'un abonnement, et de supprimer le message de cette file d'attente ou de cet abonnement en une opération atomique.

Méthode

URI de demande

Version HTTP

Méthode delete

http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head

Or

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head

HTTP/1.1

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs. Outre les propriétés répertoriées, l'en-tête peut contenir des propriétés personnalisées. Consultez l'exemple.

En-tête de demande

Description

Authorization

Spécifie l'un des éléments suivants :

  • Un jeton WRAPv0.9.7.2 contenant un SimpleWebToken acquis d'ACS. La valeur WRAP access_token = « {swt} ».

  • Jeton SAS.

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

code

Description

200

Message correctement récupéré et supprimé.

204

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

400

Demande incorrecte.

401

Échec de l'autorisation.

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 d'état et Codes d'erreur.

La réponse de l'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 sont conformes à la spécification du protocole HTTP/1.1.

Le corps de la réponse est le corps du message récupéré.

La requête HTTP suivante reçoit et supprime un message d'une file d'attente :

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1 Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey Host: your-namespace.servicebus.windows.net Content-Length: 0

Service Bus Renvoie la réponse suivante. Le message contient les propriétés personnalisées « Priority » et « Customer » :

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/atom+xml;type=entry;charset=utf-8 Server: Microsoft-HTTPAPI/2.0 BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10} Priority: "High" Customer: "12345,ABC" Date: Tue, 01 Jul 2014 23:00:23 GMT 12 This is a message. 0
Afficher: