Enviar lote de mensagens

Envia um lote de mensagens para uma fila ou tópico do Service Bus.

Solicitar

Método	Solicitar URI	Versão HTTP
PUBLICAR	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath|topicPath}/messages|HTTP/1.1

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais. Além das propriedades listadas, o cabeçalho pode conter propriedades personalizadas. Veja o exemplo.

Cabeçalho da solicitação	Descrição
Autorização	Especifique um dos seguintes valores de token: Token Web Entra JSON (JWT) da Microsoft. Exemplo: Authorization: Bearer <Azure AD JWT token>. Para obter informações sobre como gerar um token do Microsoft Entra, consulte Autenticar a partir de um aplicativo. Um token SAS. Exemplo: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. Para obter informações sobre como gerar um token SAS, consulte Gerar um token de assinatura de acesso compartilhado e Gerar token SAS.
Tipo de conteúdo	Defina como aplicativo/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Opcional) Defina como NoRetry para desativar a repetição automática em operações de envio no caso de erros transitórios.

Órgão do Pedido

O corpo da solicitação contém o lote de mensagens codificado em JSON.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
201	Mensagem enviada com êxito para a fila ou tópico.
400	Mau pedido.
401	Falha de autorização.
403	Quota excedida ou mensagem demasiado grande.
410	Fila ou tópico especificado não existe.
500	Erro interno.

Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

Tipo de conteúdo conforme passado.

Organismo de resposta

Nenhuma.

Exemplo

A solicitação HTTP a seguir envia um lote de três mensagens para uma fila ou tópico. A primeira mensagem tem um valor TimeToLiveTimeSpan de 40 segundos, a segunda mensagem tem uma propriedade de mensagem personalizada "Priority" e a terceira mensagem tem as propriedades de mensagem personalizada "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"}  
  }  
]  
  

O Barramento de Serviço retorna a seguinte resposta:

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  

Ver também