Compartir a través de

Eliminar mensaje

  • Artículo

Esta operación finaliza el procesamiento de un mensaje bloqueado y lo elimina de la cola o suscripción. Solo se debe llamar a esta operación tras el procesamiento correcto de un mensaje que estaba bloqueado, con objeto de mantener la garantía de entrega Una vez como mínimo.

Solicitud

Método URI de solicitud Versión HTTP
Delete 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 identificador URI

El URI se especifica en el encabezado Location del mensaje inspeccionado. También se puede generar 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 devuelve BrokerProperties{MessageId} la operación de mensaje Vistazo.
sequence-number Número de secuencia del mensaje que se va a eliminar tal y como devuelve BrokerProperties{SequenceNumber} la operación de mensaje Vistazo.
lockToken Token del bloqueo del mensaje que se va a eliminar tal y como devuelve la operación de mensaje de Vistazo en BrokerProperties{LockToken}.

Encabezados de solicitud

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

Encabezado de solicitud Descripción
Authorization Especifique uno de los siguientes valores de token:
  • Microsoft Entra ID token web JSON (JWT).
    Ejemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obtener información sobre cómo generar un token de Microsoft Entra, consulte Obtención de 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 Generar un token de firma de acceso compartido y Generar token de SAS.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y el cuerpo de 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 especificado MessageId o LockToken.
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 error.

Encabezados de respuesta

Encabezado de respuesta Descripción
Content-Type Se establece en application/atom+xml;type=entry;charset=utf-8.

Cuerpo de la respuesta

Ninguno.

Ejemplo

La solicitud HTTP siguiente 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

Ejemplo de cliente HTTP de Service Bus