VENTAS: 1-800-867-1389

Put Message (API de REST)

Actualizado: septiembre de 2014

La operación Put Message agrega un nuevo mensaje al final 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 un tamaño máximo de 64 KB para las versiones 2011-08-18 y más recientes, o de 8 KB para las versiones anteriores.

La solicitud Put Message se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y myqueue por 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 el parámetro opcional visibilitytimeout son compatibles con SDK 1.6 y versiones más recientes.

Al realizar una solicitud en el 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

Para obtener más información, vea About Development Storage.

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

 

Parámetro Descripción

visibilitytimeout=<int=seconds>

Opcional. Si se especifica, la solicitud se debe realizar con una x-ms-version de la versión 2011-08-18 o una más reciente. 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. El parámetro timeout se expresa en segundos. 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 solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Obligatorio. 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

Obligatorio. 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 Control de versiones de los servicios de almacenamiento de Azure.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de almacenamiento de Windows Azure: usar registros para llevar el seguimiento de 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 son conformes 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.

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

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft