Envoyer un lot de messages

Envoie un lot de messages à une file d’attente ou une rubrique Service Bus.

Demander

Méthode	URI de requête	Version de HTTP
PUBLIER	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath|topicPath}/messages|HTTP/1.1

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs. Les en-têtes personnalisés sur cette requête ne sont pas appliqués aux messages du lot. Pour définir des propriétés personnalisées sur un message dans un lot, utilisez l’objet UserProperties de ce message dans le corps de la requête. Consultez l’exemple.

En-tête de requête	Description
Autorisation	Spécifiez l’une des valeurs de jeton suivantes : Jeton JWT (Microsoft Entra JSON Web Token). Exemple : Authorization: Bearer <Azure AD JWT token>. Pour plus d’informations sur la génération d’un jeton Microsoft Entra, consultez Authentifier à partir d’une application. Jeton SAP. Exemple : Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. Pour plus d’informations sur la génération d’un jeton SAP, consultez Générer un jeton de signature d’accès partagé et Générer un jeton SAP.
Type de contenu	Défini sur application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Facultatif) Définissez la valeur NoRetry pour désactiver les nouvelles tentatives automatiques lors des opérations d’envoi en cas d’erreurs temporaires.

Corps de la demande

Le corps de la requête contient le lot de messages encodé au format JSON.

Réponse

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
201	Message envoyé avec succès à la file d’attente ou à la rubrique.
400	Demande incorrecte.
401	Échec de l’autorisation.
403	Quota dépassé ou message trop volumineux.
410	La file d’attente ou la rubrique spécifiée 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

de type contenu tel qu’il est passé.

Corps de la réponse

Aucun.

Exemple

La requête HTTP suivante envoie un lot de trois messages à une file d’attente ou une rubrique. Le premier message a une valeur TimeToLiveTimeSpan de 40 secondes, le deuxième message possède une propriété Priorityde message personnalisée , et le troisième message possède les propriétés Priority de message personnalisées et Customer.

POST https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Content-Type: application/vnd.microsoft.servicebus.json  
Host: your-namespace.servicebus.windows.net  
Content-Length: 18  
Expect: 100-continue  
  
[  
  {  
    "Body":"This is the first message",  
    "BrokerProperties":{"Label":"M1","TimeToLiveTimeSpan":"0.00:00:40"}  
  },  
  {  
    "Body":"This is the second message",  
    "BrokerProperties":{"Label":"M2"},  
    "UserProperties":{"Priority":"Low"}  
  },  
  {  
    "Body":"This is the third message",  
    "BrokerProperties":{"Label":"M3"},  
    "UserProperties":{"Priority":"Medium","Customer":"ABC"}  
  }  
]  
  

Service Bus retourne la réponse suivante :

HTTP/1.1 201 Created  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:22 GMT  
  
0  

Voir aussi