Usuń wiadomość

Ta operacja kończy przetwarzanie zablokowanego komunikatu i usuwa go z kolejki lub subskrypcji. Ta operacja powinna być wywoływana tylko po pomyślnym przetworzeniu wcześniej zablokowanego komunikatu w celu zachowania gwarancji dostarczania co najmniej raz .

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	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, który ma zostać usunięty w sposób zwrócony BrokerProperties{MessageId} przez operację Podgląd Message.
sequence-number	Numer sekwencji komunikatu, który ma zostać usunięty w sposób zwrócony BrokerProperties{SequenceNumber} przez operację Podgląd Message.
lockToken	Token blokady komunikatu, który ma zostać usunięty, zwrócony przez operację Podgląd Message w pliku BrokerProperties{LockToken}.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań. Oprócz wymienionych właściwości nagłówek może zawierać właściwości niestandardowe. Zobacz przykład.

Nagłówek żądania

Opis

Autoryzacja

Określ jedną z następujących wartości tokenu: Tożsamość Microsoft Entra token internetowy JSON (JWT). Przykład: Authorization: Bearer <Azure AD JWT token>. Aby uzyskać informacje na temat generowania tokenu Microsoft Entra, zobacz Uzyskiwanie tokenu Microsoft Entra. 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	Komunikat został pomyślnie usunięty.
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

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 usuwa komunikat z kolejki:

DELETE 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