Renew-Lock dla wiadomości

Odnawia blokadę na już zablokowanym komunikacie.

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
POST	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken} lub http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

Parametry identyfikatora URI

Identyfikator URI jest podany w nagłówku Location podglądu komunikatu lub można go skonstruować z części opisanych w poniższej tabeli.

Parametr	Opis
messageId	Identyfikator komunikatu zwrócony BrokerProperties{MessageId} przez operację Podgląd komunikatu , dla której ma zostać odnowiona blokada.
sequence-number	Numer sekwencji komunikatu zwrócony przez BrokerProperties{SequenceNumber} operację Podgląd komunikatu , dla której ma zostać odnowiona blokada.
lockToken	Token blokady komunikatu zwrócony przez operację Podgląd komunikatu w BrokerProperties{LockToken}programie , dla której blokada ma zostać odnowiona.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania

Opis

Autoryzacja

Określ jedną z następujących wartości tokenu: Token tokenu internetowego JSON (JWT) usługi Azure Active Directory (Azure AD). Przykład: Authorization: Bearer <Azure AD JWT token>. Aby uzyskać informacje na temat generowania tokenu Azure AD, zobacz Uwierzytelnianie z aplikacji. Token SAS. Przykład: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. Aby uzyskać informacje na temat generowania tokenu SAS, zobacz Generowanie tokenu sygnatury dostępu współdzielonego i Generowanie tokenu SYGNATURy dostępu współdzielonego.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kody odpowiedzi

Kod	Opis
200	Pomyślnie odnowiono blokadę komunikatu.
401	Niepowodzenie autoryzacji.
404	Nie znaleziono żadnego komunikatu z określonym MessageId elementem lub LockToken.
410	Określona kolejka lub subskrypcja nie istnieje.
500	Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
Content-Type	Ustaw wartość application/atom+xml;type=entry;charset=utf-8.

Treść odpowiedzi

Brak.

Przykład

Następujące żądanie HTTP odnawia blokadę zablokowanego komunikatu:

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  

Usługa Service Bus zwraca następującą odpowiedź:

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  

Zobacz też

Przykład klienta HTTP usługi Service Bus