Udostępnij przez

Renew-Lock komunikatu

Odnawia blokadę na już zablokowanym komunikacie.

Prosić

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 udostępniany w nagłówku Location podglądu komunikatu lub można utworzyć go z części opisanych w poniższej tabeli.

Parametr Opis
messageId Identyfikator komunikatu zwrócony w BrokerProperties{MessageId} przez operację Podgląd komunikatu, dla której ma zostać odnowiona blokada.
sequence-number Numer sekwencji komunikatu zwrócony w BrokerProperties{SequenceNumber} przez 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}, 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) firmy Microsoft.
    Przykład: Authorization: Bearer <Azure AD JWT token>.
    Aby uzyskać informacje na temat generowania tokenu entra firmy Microsoft, zobacz Uwierzytelnianie na podstawie aplikacji.
  • Token SYGNATURY dostępu współdzielonego.
    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 SAS.

Treść żądania

Żaden.

Odpowiedź

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

Kody odpowiedzi

Kod Opis
200 Blokada komunikatu została pomyślnie odnowiona.
401 Niepowodzenie autoryzacji.
404 Nie znaleziono komunikatu z określonym MessageId lub LockToken.
410 Określona kolejka lub subskrypcja nie istnieje.
500 Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji zawiera następujące nagłówki. Odpowiedź może również zawierać bardziej standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1 .

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

Treść odpowiedzi

Żaden.

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ż

  • Last updated on