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 | HTTP Version |
|---|---|---|
| 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. 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 :
|
| 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 un TimeToLiveTimeSpan valeur 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