Compartir a través de

Renew-Lock de un mensaje

Renueva el bloqueo en un mensaje ya bloqueado.

Pedir

Método URI de solicitud Versión HTTP
EXPONER 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 Location del mensaje que aparece, o bien puede construirlo a partir de los elementos descritos en la tabla siguiente.

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

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

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

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 renueva el bloqueo para 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

  • Last updated on