Exportar (0) Imprimir
Expandir todo

Delete Message

Actualizado: septiembre de 2011

La operación Delete Message elimina el mensaje especificado.

La solicitud Delete Message se puede construir como sigue. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento, myqueue por el nombre de la cola y string-value por el valor de la recepción de confirmación que se ha obtenido para el mensaje que se va a eliminar:

 

Método URI de solicitud Versión de HTTP

DELETE

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

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

DELETE

http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value

HTTP/1.1

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

El URI de solicitud admite los siguientes parámetros.

 

Parameter Descripción

popreceipt

Obligatorio. Valor de recepción de confirmación válido devuelto desde una llamada anterior a la operación Get Messages o Update Message (API de REST).

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 O bien 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 Windows Azure: usar registros para realizar un seguimiento de las solicitudes de almacenamiento.

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 204 (Sin contenido).

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

La repuesta para esta operación incluye los encabezados siguientes. La respuesta también incluye 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.

Cuando un mensaje se elimina correctamente, se marca inmediatamente para su eliminación y los clientes ya no pueden tener acceso a él. El mensaje se quita más tarde de la cola durante la recolección de elementos no utilizados.

Cuando un cliente recupera un mensaje con la operación Get Messages, se espera que el cliente procese y elimine el mensaje. Para eliminar el mensaje, es necesario disponer de dos elementos de datos devueltos en el cuerpo de respuesta de la operación Get Messages:

  • El identificador del mensaje, un valor de GUID opaco que identifica el mensaje en la cola.

  • Una recepción de confirmación válida que indica que se ha recuperado el mensaje.

El identificador del mensaje lo devuelve la operación Get Messages anterior. La recepción de confirmación la devuelve la operación Get Messages o la operación Update Message más reciente. Para que la operación Delete Message se realice correctamente, la recepción de confirmación especificada en la solicitud debe coincidir con la recepción de confirmación devuelta por la operación Get Messages o Update Message.

Las confirmaciones de recepción siguen siendo válidas hasta que ocurre uno de los eventos siguientes:

  1. El mensaje ha expirado.

  2. El mensaje se ha eliminado utilizando la última recepción de confirmación recibida de la operación Get Messages o Update Message.

  3. El tiempo de invisibilidad ha transcurrido y el mensaje se ha quitado de la cola mediante una solicitud Get Messages. Cuando se agota el tiempo de invisibilidad, el mensaje se hace visible de nuevo. Si se recupera mediante otra solicitud Get Messages, la confirmación de recepción devuelta se puede utilizar para eliminar o actualizar el mensaje.

  4. El mensaje se ha actualizado con un nuevo tiempo de espera de visibilidad. Cuando se actualice el mensaje, se devolverá una nueva recepción de confirmación.

Si no se encuentra un mensaje con una recepción de confirmación coincidente, el servicio devuelve el código de error 404 (No encontrado). Este error se producirá en los casos enumerados anteriormente en los que la recepción de confirmación ya no es válida.

Mostrar:
© 2014 Microsoft