Clear Messages
La operación Clear Messages elimina todos los mensajes de la cola especificada.
Solicitud
Puede construir la solicitud de la Clear Messages siguiente manera. Se recomienda HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y reemplace myqueue por el nombre de la cola.
| Método | URI de solicitud | Versión de HTTP |
|---|---|---|
DELETE |
https://myaccount.queue.core.windows.net/myqueue/messages |
HTTP/1.1 |
URI para el 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 |
HTTP/1.1 |
Parámetros del identificador URI
Puedes especificar los siguientes parámetros adicionales en el URI de la solicitud:
| Parámetro | Descripción |
|---|---|
timeout |
Opcional. El parámetro timeout se expresa en segundos. Para más información, consulte Establecimiento de tiempos de espera para las operaciones de Queue Storage. |
Encabezados de solicitud
En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales:
| Encabezado de solicitud | Descripción |
|---|---|
Authorization |
Necesario. Especifica el esquema de autorización, el nombre de 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. |
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, consulte Códigos de estado y error.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también incluye 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 |
Identifica de forma única la solicitud que se realizó. Puede usar este encabezado 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 que se usa 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 en la que el servicio envió la respuesta. |
x-ms-client-request-id |
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 y el valor es como máximo de 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
Solo el propietario de la cuenta puede llamar a esta operación.
Observaciones
Si una cola contiene un gran número de mensajes, Clear Messages puede agotar el tiempo de espera antes de que se hayan eliminado todos los mensajes. En este caso, Queue Storage devuelve el código de estado 500 (error interno del servidor), con el código de error adicional OperationTimedOut. Si recibe este código de error, es posible que la operación se haya realizado correctamente en el lado servidor y debe consultar el estado del servidor antes de volver a intentar la operación. Si se agota el tiempo de espera de la operación y se determina que no se ha realizado correctamente en el lado servidor, el cliente debe continuar reintentos Clear Messages hasta que se realice correctamente para asegurarse de que se han eliminado todos los mensajes.
Consulte también
Códigos de error de Queue Storage
Autorización de solicitudes a Azure Storage
Estado y códigos de error