Enviar lote de mensajes

Artículo
07/19/2023

Envía un lote de mensajes a una cola o tema de Service Bus.

Solicitud

Método	URI de solicitud	Versión HTTP
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath\|topicPath}/messages\|HTTP/1.1`

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales. Además de las propiedades mencionadas, el encabezado puede contener propiedades personalizadas. Vea el ejemplo siguiente.

Encabezado de solicitud	Descripción
Authorization	Especifique uno de los siguientes valores de token: Token web JSON (JWT) de Azure Active Directory (Azure AD). Ejemplo: `Authorization: Bearer <Azure AD JWT token>`. Para obtener información sobre cómo generar un token de Azure AD, consulte Autenticación desde una aplicación. Un token de SAS. Ejemplo: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Para obtener información sobre cómo generar un token de SAS, consulte Generar un token de firma de acceso compartido y Generar token de SAS.
Content-Type	Se establece en application/vnd.microsoft.servicebus.json.
x-ms-retrypolicy	(Opcional) Establézcalo `NoRetry` en para deshabilitar el reintento automático en las operaciones de envío en caso de errores transitorios.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene el lote de mensajes codificados en JSON.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Códigos de respuesta

Código	Descripción
201	Mensaje enviado correctamente a la cola o el tema.
400	Solicitud incorrecta.
401	Error de autorización.
403	Se ha superado la cuota o el mensaje es demasiado grande.
410	La cola o el tema especificado no existen.
500	Error interno.

Para obtener información sobre los códigos de estado, vea Códigos de estado y error.

Encabezados de respuesta

Content-type tal como se ha pasado.

Cuerpo de la respuesta

Ninguno.

Ejemplo

La solicitud HTTP siguiente envía un lote de tres mensajes a una cola o un tema. El primer mensaje tiene un valor TimeToLiveTimeSpan de 40 segundos, el segundo mensaje tiene una propiedad de mensaje personalizada "Priority" y el tercer mensaje tiene las propiedades de mensaje personalizadas "Priority" y "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"}  
  }  
]

Service Bus devuelve la siguiente respuesta:

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 también

Ejemplo de cliente HTTP de Service Bus

Share via