Eliminar mensaje (Azure Storage)

  • Artículo

La Delete Message operación elimina el mensaje especificado de la cola.

Request

Puede construir la Delete Message solicitud como se indica a continuación. Se recomienda HTTPS.

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

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 confirmación pop que se ha obtenido para que se elimine el mensaje.

URI del servicio de almacenamiento emulado

Cuando realice una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto de Azure Queue Storage como 127.0.0.1:10001, seguido del nombre de la cuenta de almacenamiento emulada.

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

Parámetros del identificador URI

El URI de solicitud admite los siguientes parámetros.

Parámetro Descripción
popreceipt Necesario. Valor de recibo emergente válido devuelto desde una llamada anterior a la operación Obtener mensajes o Actualizar mensaje .
timeout Opcional. El parámetro timeout se expresa en segundos. Para más información, consulte Configuración de tiempos de espera para las operaciones de Queue Storage.

Encabezados de solicitud

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

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
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 de Azure Storage.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para más información, consulte Supervisión de Azure Queue Storage.

Cuerpo de la solicitud

Ninguno.

Response

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

status code

Una operación correcta devuelve el código de estado 204 (Sin contenido). Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también incluye encabezados HTTP adicionales y 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 usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Indica la versión de Queue Storage usada 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 que indica la hora a la que se inició la respuesta. El servicio genera este valor.
x-ms-client-request-id Este encabezado se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud. El valor tiene como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Response body

Ninguno.

Authorization

El propietario de la cuenta puede realizar esta operación. Además, cualquier persona con una firma de acceso compartido que tenga permiso para realizar esta operación puede realizarla.

Comentarios

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

Después de que un cliente recupere un mensaje con la operación Obtener mensajes , 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 Delete Message operación se realice correctamente, el recibo pop especificado en la solicitud debe coincidir con el recibo pop devuelto de la Get Messages operación o Update Message .

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

  • El mensaje expira.

  • El mensaje se elimina mediante el último recibo emergente recibido, ya sea de Get Messages o Update Message.

  • El tiempo de espera de invisibilidad expira y una Get Messages solicitud elimina el mensaje. Cuando expira el tiempo de espera de invisibilidad, el mensaje vuelve a ser visible. Si se recupera mediante otra Get Messages solicitud, el recibo emergente devuelto se puede usar para eliminar o actualizar el mensaje.

  • El mensaje se actualiza con un nuevo tiempo de espera de visibilidad. Cuando se actualiza el mensaje, se devuelve un nuevo recibo emergente.

Si no se encuentra un mensaje con una confirmación emergente coincidente, el servicio devuelve el código de error 404 (no encontrado). Este error se produce en los casos enumerados anteriormente en los que el recibo pop ya no es válido.

Consulte también

Autorización de solicitudes a Azure Storage
Estado y códigos de error
Códigos de error de Queue Storage