Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
|
| 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