Enviar Lote de Mensagens

Artigo
07/19/2023

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

Pedir

Método	URI do pedido	Versão HTTP
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Cabeçalhos de Pedido

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

Cabeçalho do Pedido	Description
Autorização	Especifique um dos seguintes valores de token: Token Web JSON (JWT) do Azure Active Directory (Azure AD). Exemplo: `Authorization: Bearer <Azure AD JWT token>`. Para obter informações sobre como gerar um token de Azure AD, veja Authenticate from an application (Autenticar a partir de uma aplicação). Um token de 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 de SAS, veja Gerar um token de Assinatura de Acesso Partilhado e Gerar token de SAS.
Content-Type	Definido como application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Opcional) Defina como para `NoRetry` desativar a repetição automática nas operações de envio em caso de erros transitórios.

Corpo do Pedido

O corpo do pedido contém o lote de mensagens codificadas em JSON.

Resposta

A resposta inclui um código de estado 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	Pedido incorreto.
401	Falha de autorização.
403	Quota excedida ou mensagem demasiado grande.
410	A fila ou tópico especificado não existe.
500	Erro interno.

Para obter informações sobre códigos de estado, veja Códigos de Estado e erro.

Cabeçalhos de Resposta

Tipo de conteúdo conforme transmitido.

Corpo da Resposta

Nenhum.

Exemplo

O seguinte pedido HTTP 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 "Prioridade" e a terceira mensagem tem as propriedades da mensagem personalizada "Prioridade" e "Cliente".

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 Service Bus devolve 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

Consulte também

Exemplo de Cliente HTTP do Service Bus

Partilhar via