Envoi d'un lot de messages
Envoie un lot de messages à une file d’attente ou une rubrique Service Bus.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | 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 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 :
|
| Content-Type | A pour valeur application/vnd.microsoft.servicebus.json. |
| x-ms-retrypolicy | (Facultatif) Définissez sur NoRetry pour désactiver les nouvelles tentatives automatiques sur les opérations d’envoi en cas d’erreurs temporaires. |
Corps de la requête
Le corps de la demande contient le lot de messages en code JSON.
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 |
|---|---|
| 201 | Message correctement envoyé à une file d'attente ou une 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 status, consultez Codes d’état et d’erreur.
En-têtes de réponse
Content-type tel qu'il est transmis.
Corps de la réponse
Aucun.
Exemple
La requête HTTP suivante envoie un lot de trois messages vers une file d'attente ou une rubrique. Le premier message a une valeur TimeToLiveTimeSpan de 40 secondes, le deuxième message a une propriété de message personnalisée « Priority », et le troisième message a les propriétés de message personnalisées « Priority » 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