DeleteMessage - Simple Message Queue (formerly MNS) - Centre de documentation Alibaba Cloud

Supprime un message consommé d'une file d'attente à l'aide de son descripteur de réception.

Propriété	Valeur
API	DeleteMessage
Action	mns:DeleteMessage
Resource	acs:mns:$region:$accountid:/queues/$queueName/messages

Description

L'opération DeleteMessage supprime un message d'une file d'attente une fois celui-ci consommé. Pour identifier le message, indiquez le descripteur de réception renvoyé par le dernier appel ReceiveMessage.

Le descripteur de réception n'est valide que jusqu'à l'heure spécifiée par NextVisibleTime. Passé ce délai, le message repasse à l'état Actif et le descripteur de réception expire. Pour supprimer le message après l'expiration du descripteur, consommez-le à nouveau afin d'obtenir un nouveau descripteur.

Important

Chaque opération de consommation renvoie un descripteur de réception différent. Utilisez toujours le descripteur issu de la dernière opération de réception. Les anciens descripteurs ne sont plus valides pour la suppression.

Requête

Ligne de requête

DELETE /queues/$queueName/messages? ReceiptHandle=<receiptHandle> HTTP/1.1

Paramètres URI

Paramètre	Type	Obligatoire	Description
ReceiptHandle	String	Oui	Descripteur de réception renvoyé lors de la dernière consommation du message. Pour plus d'informations, consultez la section ReceiveMessage.

En-têtes de requête

Aucun en-tête de requête spécifique à l'opération.

Corps de la requête

Aucun.

Réponse

Réponse en cas de succès

HTTP/1.1 204 No Content

En-têtes de réponse

Aucun en-tête de réponse spécifique à l'opération.

Corps de la réponse

Aucun.

Exemples

Exemple de requête

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****

Exemple de réponse

HTTP/1.1 204 No Content
x-mns-request-id: 512B2A634403E52B1956****
x-mns-version: 2015-06-06

Codes d'erreur

Code d'erreur	Code d'état HTTP	Message d'erreur	Description
QueueNotExist	404	The queue name you provided does not exist.	La file d'attente spécifiée n'existe pas. Vérifiez le nom de la file d'attente dans l'URI de la requête.
InvalidArgument	400	The value of Element should between Low and High seconds/bytes.	La valeur d'un paramètre est hors plage. Vérifiez les paramètres de la requête par rapport aux plages de valeurs autorisées.
ReceiptHandleError	400	The receipt handle you provided is not valid.	Le descripteur de réception a expiré car `NextVisibleTime` est dépassé, ou un ancien descripteur a été utilisé. Consommez à nouveau le message pour obtenir un nouveau descripteur de réception.