Partager via


Renew-Lock pour un message

Renouvelle le verrou sur un message déjà verrouillé.

Demander

Méthode URI de requête HTTP Version
PUBLIER http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

ou

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Paramètres d’URI

L’URI est fourni dans l’en-tête Location du message aperçu, ou vous pouvez le construire à partir des parties décrites dans le tableau suivant.

Paramètre Description
messageId ID du message, tel qu’il est retourné dans BrokerProperties{MessageId} par l’opération Aperçu du message, pour laquelle le verrou doit être renouvelé.
sequence-number Numéro de séquence du message, tel qu’il est retourné dans BrokerProperties{SequenceNumber} par l’opération message d’aperçu, pour laquelle le verrou doit être renouvelé.
lockToken Jeton du verrou du message, tel que retourné par l’opération Aperçu du message dans BrokerProperties{LockToken}, pour lequel le verrou doit être renouvelé.

En-têtes de requête

Le tableau suivant décrit les en-têtes de requête obligatoires et facultatifs.

En-tête de requête Description
Autorisation Spécifiez l’une des valeurs de jeton suivantes :

Corps de la demande

Aucun.

Réponse

La réponse inclut un code d’état HTTP, un ensemble d’en-têtes de réponse et le corps de la réponse.

Codes de réponse

Code Description
200 Verrouillage de message renouvelé avec succès.
401 Échec de l’autorisation.
404 Aucun message n’a été trouvé avec le MessageId ou LockTokenspécifié.
410 La file d’attente ou l’abonnement spécifié n’existe pas.
500 Erreur interne.

Pour plus d’informations sur les codes d’état, consultez Status and Error Codes.

En-têtes de réponse

La réponse de cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP plus standard. Tous les en-têtes standard sont conformes à la spécification de protocole HTTP/1.1 .

En-tête de réponse Description
Type de contenu Défini sur application/atom+xml;type=entry;charset=utf-8.

Corps de la réponse

Aucun.

Exemple

La requête HTTP suivante renouvelle le verrou pour un message verrouillé :

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 retourne la réponse suivante :

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  

Voir aussi