Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Put Message

 

La Put Message operación agrega un nuevo mensaje a la parte posterior de la cola de mensajes. También se puede especificar un tiempo de espera de visibilidad para que el mensaje sea invisible hasta que caduque el tiempo de espera de visibilidad. Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. El mensaje codificado puede tener hasta 64 KB de tamaño para las versiones 2011-08-18 y más reciente, o de 8 KB de tamaño para las versiones anteriores.

El Put Message solicitud se puede generar como sigue. Se recomienda HTTPS. Reemplace myaccount con el nombre de la cuenta de almacenamiento y myqueue con el nombre de la cola:

Método

URI de solicitud

Versión de HTTP

POST

https://myaccount.queue.core.windows.net/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

Esta operación y opcional visibilitytimeout parámetro son compatibles con SDK 1.6 y versiones más recientes.

Al realizar una solicitud al servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio cola como 127.0.0.1:10001, seguido del nombre de la cuenta de almacenamiento emulado:

Método

URI de solicitud

Versión de HTTP

POST

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages?visibilitytimeout=<int-seconds>&messagettl=<int-seconds>

HTTP/1.1

Se pueden especificar los parámetros siguientes en el URI de solicitud.

Parámetro

Descripción

visibilitytimeout=<int=seconds>

Opcional. Si se especifica, se debe realizar la solicitud con un x-ms-version de 2011-08-18 o posterior. Si no se especifica ningún valor, se utiliza el valor predeterminado 0. Especifica el nuevo valor del tiempo de espera de visibilidad, en segundos, relativo a la hora del servidor. El nuevo valor debe ser mayor o igual que 0, y no puede ser mayor de 7 días. El tiempo de espera de visibilidad de un mensaje no puede establecerse en un valor posterior a la hora de expiración. visibilitytimeout debe establecerse en un valor menor que el valor de período de vida.

messagettl=<int-seconds>

Opcional. Especifica el intervalo del período de vida para el mensaje, en segundos. El período de vida máximo admitido es de 7 días. Si se omite este parámetro, el período de vida predeterminado es de 7 días.

timeout

Opcional. La propiedad SIDHistory hace esto posible. Para obtener más información, vea Establecer los tiempos de espera para las operaciones del servicio Cola.

En la tabla siguiente se describen los encabezados de solicitudes requeridos y opcionales.

Encabezado de solicitud

Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date or x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Opcional. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB registrado en los registros de análisis cuando está habilitado registro del análisis de almacenamiento. Es muy recomendable usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, consulte Acerca del registro del análisis de almacenamiento y registro de Azure: Usar registros para seguir las solicitudes de almacenamiento.

El cuerpo de la solicitud contiene los datos del mensaje en el formato XML siguiente. Tenga en cuenta que el contenido del mensaje debe estar en un formato que se pueda codificar con UTF-8.

<QueueMessage> <MessageText>message-content</MessageText> </QueueMessage>

Request: POST https://myaccount.queue.core.windows.net/messages?visibilitytimeout=30&timeout=30 HTTP/1.1 Headers: x-ms-version: 2011-08-18 x-ms-date: Tue, 30 Aug 2011 01:03:21 GMT Authorization: SharedKey myaccount:sr8rIheJmCd6npMSx7DfAY3L//V3uWvSXOzUBCV9wnk= Content-Length: 100 Body: <QueueMessage> <MessageText>PHNhbXBsZT5zYW1wbGUgbWVzc2FnZTwvc2FtcGxlPg==</MessageText> </QueueMessage>

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

Una operación correcta devuelve el código de estado 201 (Creado).

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

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de solicitud

Descripción

x-ms-request-id

Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para obtener más información, vea Solucionar problemas relacionados con las operaciones de la API.

x-ms-version

Indica la versión del servicio Cola utilizada para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.

Date

Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.

Esta operación la puede realizar el propietario de la cuenta y cualquiera que tenga una firma de acceso compartido con permiso para realizar esta operación.

El tiempo de espera de visibilidad opcional especifica el tiempo que el mensaje no estará visible. Una vez agotado el tiempo de espera, el mensaje se hará visible. Si no se especifica un tiempo de espera de visibilidad, se utiliza el valor predeterminado 0.

El período de vida de los mensajes opcional especifica el tiempo que permanecerá un mensaje en la cola. El mensaje se eliminará de la cola cuando caduque el período de vida.

Un mensaje debe estar en un formato tal que se pueda incluir en una solicitud XML con codificación UTF-8. Para incluir marcado en el mensaje, sus contenidos deben tener escape XML o codificación Base64. El marcado XML del mensaje que no tenga escape o codificación se eliminará antes de que dicho mensaje se añada a la cola.

Si el mensaje es demasiado grande, el servicio devuelve el código de estado 400 (Solicitud incorrecta).

Mostrar: