Usuwanie komunikatu (Azure Storage)

Operacja Delete Message usuwa określony komunikat z kolejki.

Żądanie

Żądanie można skonstruować Delete Message w następujący sposób. Zalecane jest użycie protokołu HTTPS.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value	HTTP/1.1

Zastąp myaccount ciąg nazwą konta magazynu, myqueue nazwą kolejki i string-value wartością potwierdzenia podręcznego uzyskanego dla komunikatu, który ma zostać usunięty.

Identyfikator URI usługi magazynu emulowanego

Po wysłaniu żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi Azure Queue Storage jako 127.0.0.1:10001, a następnie nazwę emulowanego konta magazynu.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value	HTTP/1.1

Parametry identyfikatora URI

Identyfikator URI żądania obsługuje następujące parametry.

Parametr	Opis
popreceipt	Wymagane. Prawidłowa wartość potwierdzenia wyskakującego zwrócona z wcześniejszego wywołania operacji Pobierz komunikaty lub Aktualizuj komunikat .
timeout	Opcjonalny. Parametr jest wyrażony timeout w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Queue Storage.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Authorization	Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date	Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version	Opcjonalny. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
x-ms-client-request-id	Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitorowanie usługi Azure Queue Storage.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 204 (Brak zawartości). Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź zawiera również dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek żądania	Opis
x-ms-request-id	Ten nagłówek jednoznacznie identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API.
x-ms-version	Wskazuje wersję usługi Queue Storage używaną do uruchomienia żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w wersji 2009-09-19 lub nowszej.
Date	Wartość daty/godziny UTC wskazująca godzinę, o której zainicjowano odpowiedź. Usługa generuje tę wartość.
x-ms-client-request-id	Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id , jeśli jest obecna w żądaniu. Wartość jest najwyżej 1024 widocznymi znakami ASCII. x-ms-client-request-id Jeśli nagłówek nie istnieje w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Brak.

Autoryzacja

Właściciel konta może wykonać tę operację. Ponadto każda osoba z sygnaturą dostępu współdzielonego, która ma uprawnienia do wykonania tej operacji, może ją wykonać.

Uwagi

Po pomyślnym usunięciu komunikatu zostanie on natychmiast oznaczony do usunięcia i nie będzie już dostępny dla klientów. Komunikat zostanie później usunięty z kolejki podczas odzyskiwania pamięci.

Gdy klient pobierze komunikat z operacją Pobieranie komunikatów , oczekuje się, że klient przetworzy i usunie komunikat. Aby usunąć komunikat, musisz mieć dwa elementy danych zwrócone w treści Get Messages odpowiedzi operacji:

• Identyfikator komunikatu, nieprzezroczysty identyfikator GUID, który identyfikuje komunikat w kolejce.

• Prawidłowy potwierdzenie podręczne, nieprzezroczysta wartość wskazująca, że wiadomość została pobrana.

Identyfikator komunikatu jest zwracany z poprzedniej Get Messages operacji. Potwierdzenie wyskakujące jest zwracane z najnowszej Get Messages lub Update Message operacji. Delete Message Aby operacja powiodła się, potwierdzenie wyskakujące określone na żądaniu musi być zgodne z potwierdzeniem wyskakującym zwróconym z Get Messages operacji lubUpdate Message.

Potwierdzenia pop pozostają ważne do momentu wystąpienia jednego z następujących zdarzeń:

• Komunikat wygaśnie.

• Wiadomość jest usuwana przy użyciu ostatniego potwierdzenia wyskakującego odebranego z lub Get MessagesUpdate Message.

• Limit czasu widoczności wygasa, a komunikat jest usuwany z kolejki Get Messages przez żądanie. Po wygaśnięciu limitu czasu widoczności komunikat będzie ponownie widoczny. Jeśli jest on pobierany przez inne Get Messages żądanie, zwrócone potwierdzenie wyskakujące może służyć do usunięcia lub zaktualizowania wiadomości.

• Komunikat jest aktualizowany przy użyciu nowego limitu czasu widoczności. Po zaktualizowaniu wiadomości zostanie zwrócone nowe potwierdzenie wyskakujące.

Jeśli nie można odnaleźć komunikatu z pasującym potwierdzeniem wyskakującym, usługa zwróci kod błędu 404 (Nie znaleziono). Ten błąd występuje w poprzednio wymienionych przypadkach, w których potwierdzenie podręczne nie jest już prawidłowe.

Zobacz też

Autoryzowanie żądań do usługi Azure Storage
Kody stanu i błędów
Kody błędów usługi Queue Storage