Compartilhar via

Enviar Lote de Mensagens

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

Pedir

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

Cabeçalhos de solicitação

A tabela a seguir descreve 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 de solicitação Descrição
Autorização Especifique um dos seguintes valores de token:
  • Token Web JSON do Microsoft Entra (JWT).
    Exemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obter informações sobre como gerar um token do Microsoft Entra, consulte Authenticate 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 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 codificada 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 fila ou tópico.
400 Solicitação incorreta.
401 Falha de autorização.
403 Cota excedida ou mensagem muito grande.
410 A fila ou o tópico especificados não existem.
500 Erro interno.

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

Cabeçalhos de resposta

de tipo de conteúdo conforme passado.

Corpo da resposta

Nenhum.

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 TimeToLiveTimeSpan valor de 40 segundos, a segunda mensagem tem uma propriedade de mensagem personalizada "Priority" e a terceira mensagem tem as propriedades de 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 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

  • Last updated on