Invio batch di messaggi

2025-03-19

Invia un batch di messaggi a una coda o a un argomento del bus di servizio.

Richiesta

Metodo	URI della richiesta	Versione HTTP
INSERISCI	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Intestazioni della richiesta

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative. Oltre alle proprietà elencate, l'intestazione può contenere proprietà personalizzate. Vedere l'esempio.

Intestazione richiesta	Descrizione
Autorizzazione	Specificare uno dei valori di token seguenti: Token JWT (Microsoft Entra JSON Web Token). Esempio: `Authorization: Bearer <Azure AD JWT token>`. Per informazioni sulla generazione di un token Microsoft Entra, vedere Authenticate from an application. Token di firma di accesso condiviso. Esempio: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Per informazioni sulla generazione di un token di firma di accesso condiviso, vedere Generare un token di firma di accesso condiviso e Generare un token di firma di accesso condiviso.
Tipo di contenuto	Impostare su applicazione /vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Facoltativo) Impostare su `NoRetry` per disabilitare la ripetizione automatica dei tentativi nelle operazioni di invio in caso di errori temporanei.

Corpo della richiesta

Il corpo della richiesta contiene il batch di messaggi con codifica JSON.

Risposta

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

Codici di risposta

Codice	Descrizione
201	Messaggio inviato correttamente alla coda o all'argomento.
400	Richiesta non valida.
401	Errore di autorizzazione.
403	Quota superata o messaggio troppo grande.
410	La coda o l'argomento specificato non esiste.
500	Errore interno.

Per informazioni sui codici di stato, vedere Status and Error Codes.

Intestazioni di risposta

tipo di contenuto come passato.

Corpo della risposta

Nessuno.

Esempio

La richiesta HTTP seguente invia un batch di tre messaggi a una coda o a un argomento. Il primo messaggio ha un valore TimeToLiveTimeSpan di 40 secondi, il secondo messaggio ha una proprietà di messaggio personalizzata "Priority" e il terzo messaggio ha le proprietà personalizzate del messaggio "Priority" e "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"}  
  }  
]

Il bus di servizio restituisce la risposta seguente:

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

Condividi tramite