Compartir a través de

Enviar lote de mensajes

  • Artículo

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