Udostępnij za pośrednictwem

Odblokuj wiadomość

  • Artykuł

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

Żądanie

Metoda Identyfikator URI żądania Wersja protokołu HTTP
PUT 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 Lokalizacja podglądu komunikatu lub można go skonstruować z części opisanych w poniższej tabeli.

Parametr Opis
messageId Identyfikator komunikatu, który ma zostać odblokowany BrokerProperties{MessageId} zgodnie z informacją zwróconą przez operację Podgląd komunikatu .
sequence-number Numer sekwencji komunikatu, który ma zostać odblokowany BrokerProperties{SequenceNumber} zgodnie z operacją Podgląd komunikatu .
lockToken Token blokady komunikatu, który ma zostać odblokowany zgodnie z operacją Peek Message w programie 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 opcji:
  • Token JSON Web Token (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 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 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 Komunikat został pomyślnie odblokowany.
401 Niepowodzenie autoryzacji.
404 Nie znaleziono komunikatu o określonej wartości MessageId lub LockToken.
410 Określona kolejka lub subskrypcja nie istnieje.
500 Błąd wewnętrzny.

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

Nagłówki odpowiedzi

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

Treść odpowiedzi

Brak.

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ż

Przykład klienta HTTP usługi Service Bus