Elimina un mensaje consumido de una cola mediante su identificador de recepción (receipt handle).
|
Propiedad |
Valor |
|
API |
DeleteMessage |
|
Acción |
mns:DeleteMessage |
|
Recurso |
acs:mns:$region:$accountid:/queues/$queueName/messages |
Descripción
La API DeleteMessage elimina un mensaje de una cola después de que este se haya consumido. Para identificar el mensaje, proporcione el receipt handle que devolvió la llamada más reciente a ReceiveMessage.
El receipt handle solo es válido hasta el momento que especifica NextVisibleTime. Una vez transcurrido ese tiempo, el mensaje vuelve al estado Active y el receipt handle caduca. Si necesita eliminar el mensaje después de que el identificador caduque, vuelva a consumir el mensaje para obtener un nuevo receipt handle.
Cada operación de consumo devuelve un receipt handle distinto. Utilice siempre el identificador de la operación de recepción más reciente, ya que los anteriores dejan de ser válidos para eliminar mensajes.
Solicitud
Línea de solicitud
DELETE /queues/$queueName/messages? ReceiptHandle=<receiptHandle> HTTP/1.1Parámetros del URI
|
Parámetro |
Tipo |
Obligatorio |
Descripción |
|
ReceiptHandle |
String |
Sí |
El receipt handle que se devolvió la última vez que se consumió el mensaje. Para más información, consulte ReceiveMessage. |
Encabezados de solicitud
Esta operación no requiere encabezados de solicitud específicos.
Cuerpo de la solicitud
Ninguno.
Respuesta
Respuesta exitosa
HTTP/1.1 204 No ContentEncabezados de respuesta
Esta operación no devuelve encabezados de respuesta específicos.
Cuerpo de la respuesta
Ninguno.
Ejemplos
Solicitud de ejemplo
DELETE /queues/$queueName/messages? ReceiptHandle=MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0 HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 28 May 2012 22:32:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXA****Respuesta de ejemplo
HTTP/1.1 204 No Content
x-mns-request-id: 512B2A634403E52B1956****
x-mns-version: 2015-06-06Códigos de error
|
Código de error |
Código de estado HTTP |
Mensaje de error |
Descripción |
|
QueueNotExist |
404 |
The queue name you provided does not exist. |
La cola especificada no existe. Compruebe el nombre de la cola en el URI de la solicitud. |
|
InvalidArgument |
400 |
The value of Element should between Low and High seconds/bytes. |
Un valor de parámetro está fuera del rango válido. Revise los parámetros de la solicitud y compárelos con los rangos de valores permitidos. |
|
ReceiptHandleError |
400 |
The receipt handle you provided is not valid. |
El receipt handle caducó porque ya pasó el tiempo de |