Udostępnij przez

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, aby zachować co najmniej raz zapewnienia dostarczania.

Prosić

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
USUNĄĆ 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ć usunięty w BrokerProperties{MessageId} przez operację Zobacz komunikat.
sequence-number Numer sekwencji komunikatu, który ma zostać usunięty w BrokerProperties{SequenceNumber} przez operację Zobacz komunikat.
lockToken Token blokady komunikatu, który ma zostać usunięty, zwrócony przez operację Podgląd komunikatu w 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:
  • Token JSON web tokenu JSON (JWT) identyfikatora Entra ID firmy Microsoft.
    Przykład: Authorization: Bearer <Azure AD JWT token>.
    Aby uzyskać informacje na temat generowania tokenu entra firmy Microsoft, zobacz Get an Microsoft Entra token.
  • 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 usunięty.
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 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ż

  • Last updated on