Compartir a través de

Eliminar mensaje

Esta operación completa el procesamiento de un mensaje bloqueado y lo elimina de la cola o suscripción. Solo se debe llamar a esta operación después de procesar correctamente un mensaje bloqueado previamente, con el fin de mantener garantías de entrega al menos una vez.

Pedir

Método URI de solicitud Versión HTTP
BORRAR http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

o

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Parámetros de URI

El URI se proporciona en el encabezado Location del mensaje que aparece, o bien puede construirlo a partir de las partes descritas en la tabla siguiente.

Parámetro Descripción
messageId Identificador del mensaje que se va a eliminar tal y como se devuelve en BrokerProperties{MessageId} mediante la operación Ver mensaje de.
sequence-number Número de secuencia del mensaje que se va a eliminar tal como se devuelve en BrokerProperties{SequenceNumber} mediante la operación Ver mensaje.
lockToken Token del bloqueo del mensaje que se va a eliminar tal como lo devuelve la operación Ver mensaje en BrokerProperties{LockToken}.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales. Además de las propiedades enumeradas, el encabezado puede contener propiedades personalizadas. Vea el ejemplo.

Encabezado de solicitud Descripción
Autorización Especifique uno de los siguientes valores de token:
  • Token json Json Token (JWT) del id. de Microsoft Entra ID.
    Ejemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obtener información sobre cómo generar un token de Microsoft Entra, consulte Obtener un token de Microsoft Entra.
  • Un token de SAS.
    Ejemplo: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Para obtener información sobre cómo generar un token de SAS, consulte Generación de un token de firma de acceso compartido y generación de token de SAS.

Cuerpo de la solicitud

Ninguno.

Respuesta

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y el cuerpo de la respuesta.

Códigos de respuesta

Código Descripción
200 Mensaje eliminado correctamente.
401 Error de autorización.
404 No se encontró ningún mensaje con el MessageId o LockTokenespecificados.
410 La cola o la suscripción especificadas no existen.
500 Error interno.

Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

Encabezado de respuesta Descripción
Tipo de contenido Establezca en application/atom+xml;type=entry; charset=utf-8.

Cuerpo de la respuesta

Ninguno.

Ejemplo

La siguiente solicitud HTTP elimina un mensaje de una cola:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus devuelve la siguiente respuesta:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

Consulte también

  • Last updated on