Réception et suppression de 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.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| Suppression | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/heador http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1 |
En-têtes de requête
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 requête | Description |
|---|---|
| Autorisation | Spécifiez l’une des valeurs de jeton suivantes :
|
Corps de la requête
Aucun.
response
La réponse inclut un code d'état HTTP et un ensemble d'en-têtes de réponse.
Codes 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 status, consultez Codes d’état et d’erreur.
En-têtes de réponse
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.
Corps de la réponse
Le corps de la réponse est le corps du message récupéré.
Exemple
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 retourne 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