Compartir a través de

Renovar el bloqueo de un mensaje

  • Artículo

Renueva el bloqueo de un mensaje que ya está bloqueado.

Solicitud

Método URI de solicitud Versión HTTP
POST 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, tal como lo BrokerProperties{MessageId} devuelve la operación Ver mensaje , para la que se renovará el bloqueo.
sequence-number Número de secuencia del mensaje, tal como lo devuelve BrokerProperties{SequenceNumber} la operación Ver mensaje , para la que se renovará el bloqueo.
lockToken Token del bloqueo del mensaje, tal como lo devuelve la operación Peek Message en BrokerProperties{LockToken}, para la que se renovará el bloqueo.

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 valores de token:
  • 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 Bloqueo del mensaje renovado 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

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

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

Cuerpo de la respuesta

Ninguno.

Ejemplo

La solicitud HTTP siguiente renueva el bloqueo de un mensaje bloqueado:

POST 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