Renouvellement du verrou d'un message
Renouvelle le verrou sur un message déjà verrouillé.
Requête
| Méthode | URI de demande | Version HTTP |
|---|---|---|
| POST | http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}or http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1 |
Paramètres URI
L'URI est indiqué dans l'en-tête Location de l'aperçu du message, ou vous pouvez le générer à partir des éléments décrits dans le tableau suivant.
| Paramètre | Description |
|---|---|
messageId |
ID du message, tel que retourné BrokerProperties{MessageId} par l’opération Peek Message , pour laquelle le verrou doit être renouvelé. |
sequence-number |
Numéro de séquence du message, tel que retourné BrokerProperties{SequenceNumber} par l’opération Aperçu du message , pour laquelle le verrou doit être renouvelé. |
lockToken |
Jeton du verrou du message, tel que retourné par l’opération Peek Message dans BrokerProperties{LockToken}, pour laquelle le verrou doit être renouvelé. |
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.
| En-tête de requête | Description |
|---|---|
| Autorisation | Spécifiez l’une des valeurs de jeton suivantes :
|
Corps de la requête
Aucun.
response
La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et le corps de réponse.
Codes de réponse
| Code | Description |
|---|---|
| 200 | Verrou de message correctement renouvelé. |
| 401 | Échec de l'autorisation. |
| 404 | Aucun message n’a été trouvé avec le spécifié MessageId ou LockToken. |
| 410 | La file d'attente ou l'abonnement spécifié n'existe pas. |
| 500 | Erreur interne. |
Pour plus d’informations sur les codes status, consultez Codes d’état et d’erreur.
En-têtes de réponse
La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.
| En-tête de réponse | Description |
|---|---|
| Content-Type | 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