Enviar Lote de Mensagens

Artigo
07/19/2023

Envia um lote de mensagens para uma fila ou tópico do Barramento de Serviço.

Solicitação

Método	URI da solicitação	Versão de HTTP
POST	`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. Consulte o exemplo.

Cabeçalho da solicitação	Descrição
Autorização	Especifique um dos seguintes valores de token: Token JWT (Token Web JSON) do Azure Active Directory (Azure AD). Exemplo: `Authorization: Bearer <Azure AD JWT token>`. Para obter informações sobre como gerar um token Azure AD, consulte Autenticar 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 application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Opcional) Defina como `NoRetry` para desabilitar a repetição automática em operações de envio no caso de erros transitórios.

Corpo da solicitação

O corpo da solicitação contém o lote de mensagens codificadas 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 à fila ou ao tópico.
400	Solicitação inválida.
401	Falha de autorização.
403	Cota excedida ou mensagem muito grande.
410	A fila ou o 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

Content-type, conforme transmitido.

Corpo da resposta

Nenhum.

Exemplo

A solicitação HTTP a seguir envia um lote de três mensagens a 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 personalizadas "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

Consulte Também

Exemplo de Cliente HTTP de Barramento de Serviço

Share via