Udostępnij za pośrednictwem

Odblokuj komunikat

  • Artykuł

Odblokuje komunikat do przetwarzania przez innych odbiorców w określonej subskrypcji. Ta operacja usuwa obiekt blokady, powodując odblokowanie komunikatu. Przed wywołaniem operacji odbiornik musi najpierw zablokować komunikat.

Prosić

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
KŁAŚĆ 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, który ma zostać odblokowany w BrokerProperties{MessageId} przez operację Zobacz komunikat.
sequence-number Numer sekwencji komunikatu, który ma zostać odblokowany w BrokerProperties{SequenceNumber} przez operację Zobacz komunikat.
lockToken Token blokady komunikatu do odblokowania zgodnie z operacji Podgląd komunikatu w BrokerProperties{LockToken}.

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:
  • 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 Komunikat został pomyślnie odblokowany.
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

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

Treść odpowiedzi

Żaden.

Przykład

Następujące żądanie HTTP odblokowuje komunikat:

PUT 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ż