Compartir a través de

Desbloquear mensaje

Desbloquea un mensaje para su procesamiento por otros receptores en una suscripción especificada. Esta operación elimina el objeto de bloqueo, lo que hace que se desbloquee el mensaje. Antes de llamar a la operación, un receptor debe bloquear primero el mensaje.

Pedir

Método URI de solicitud Versión HTTP
PONER 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 desbloquear tal y como se devuelve en BrokerProperties{MessageId} mediante la operación Ver mensaje.
sequence-number Número de secuencia del mensaje que se va a desbloquear como se devuelve en BrokerProperties{SequenceNumber} por la operación Ver mensaje.
lockToken Token del bloqueo del mensaje que se va a desbloquear 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.

Encabezado de solicitud Descripción
Autorización Especifique uno de los siguientes valores:
  • Token web JSON (JWT) de Microsoft Entra.
    Ejemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obtener información sobre cómo generar un token de Microsoft Entra, consulte Autenticación desde una aplicación.
  • 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 desbloqueado 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 desbloquea un mensaje:

PUT 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