Clear Messages
La operación Clear Messages elimina todos los mensajes de la cola especificada.
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 |
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 |
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. |
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. |
Ninguno.
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 sobre los códigos de estado, consulte Códigos de estado y error.
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. |
Ninguno.
Solo el propietario de la cuenta puede llamar a esta operación.
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.
Códigos de error de Queue Storage
Autorización de solicitudes a Azure Storage
Estado y códigos de error