Exclua uma mensagem consumida de uma fila por meio do receipt handle.
|
Propriedade |
Valor |
|
API |
DeleteMessage |
|
Ação |
mns:DeleteMessage |
|
Recurso |
acs:mns:$region:$accountid:/queues/$queueName/messages |
Descrição
A operação DeleteMessage remove uma mensagem da fila após o consumo. Para identificar a mensagem, forneça o receipt handle retornado pela chamada mais recente de ReceiveMessage.
O receipt handle permanece válido apenas até o horário especificado em NextVisibleTime. Após esse momento, a mensagem retorna ao estado Active e o receipt handle expira. Para excluir a mensagem após a expiração do handle, consuma-a novamente para obter um novo receipt handle.
Cada operação de consumo retorna um receipt handle diferente. Use sempre o receipt handle da operação de recebimento mais recente. Handles anteriores não são válidos para exclusão.
Solicitação
Linha de solicitação
DELETE /queues/$queueName/messages? ReceiptHandle=<receiptHandle> HTTP/1.1Parâmetros de URI
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
ReceiptHandle |
String |
Sim |
Receipt handle retornado na última vez em que a mensagem foi consumida. Para mais informações, consulte ReceiveMessage. |
Cabeçalhos de solicitação
Esta operação não possui cabeçalhos de solicitação específicos.
Corpo da solicitação
Nenhum.
Resposta
Resposta de sucesso
HTTP/1.1 204 No ContentCabeçalhos de resposta
Esta operação não possui cabeçalhos de resposta específicos.
Corpo da resposta
Nenhum.
Exemplos
Exemplo de solicitação
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****Exemplo de resposta
HTTP/1.1 204 No Content
x-mns-request-id: 512B2A634403E52B1956****
x-mns-version: 2015-06-06Códigos de erro
|
Código de erro |
Código de status HTTP |
Mensagem de erro |
Descrição |
|
QueueNotExist |
404 |
The queue name you provided does not exist. |
A fila especificada não existe. Verifique o nome da fila na URI da solicitação. |
|
InvalidArgument |
400 |
The value of Element should between Low and High seconds/bytes. |
Um valor de parâmetro está fora do intervalo válido. Verifique os parâmetros da solicitação em relação aos intervalos de valores permitidos. |
|
ReceiptHandleError |
400 |
The receipt handle you provided is not valid. |
O receipt handle expirou porque o |