Compartir a través de

Desbloquear mensaje

  • Artículo

Desbloquea un mensaje para que lo procesen otros destinatarios en una suscripción especificada. La operación elimina el objeto de bloqueo, lo que desbloquea el mensaje. Un destinatario debe bloquear el mensaje antes de que se llame a la operación.

Solicitud

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

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Especifique uno de los siguientes:
  • Token de Json Web Token (JWT) de Azure Active Directory (Azure AD).
    Ejemplo: Authorization: Bearer <Azure AD JWT token>.
    Para obtener información sobre cómo generar un token de Azure AD, 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 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 desbloqueado correctamente.
401 Error de autorización.
404 No se encontró ningún mensaje con el especificado MessageId o LockToken.
410 La cola o suscripción especificada no existe.
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 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

Ejemplo de cliente HTTP de Service Bus