Usuń komunikat (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 wyskakującego 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 usług Azure Storage.
x-ms-client-request-id	Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany 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

Operacja zakończona powodzeniem zwraca kod stanu 204 (Brak zawartości). Aby uzyskać informacje o kodach stanu, zobacz Stan i kody 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 nagłówki standardowe 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 dla żądań wysyłanych w wersji 2009-09-19 lub nowszej.
Date	Wartość daty/godziny UTC wskazująca godzinę, w 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 im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli jest obecna w żądaniu. Wartość wynosi co najwyżej 1024 widoczne znaki ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się 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 wykonać tę operację.

Uwagi

Po pomyślnym usunięciu komunikatu jest on natychmiast oznaczony do usunięcia i nie jest już dostępny.

Gdy klient pobierze komunikat z operacją Pobieranie komunikatów , klient ma przetworzyć i usunąć 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łowe potwierdzenie wyskakujące, 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 pop zwróconym z Get Messages operacji lubUpdate Message.

Potwierdzenia wyskakujące pozostają prawidłowe do momentu wystąpienia jednego z następujących zdarzeń:

• Komunikat wygaśnie.

• Wiadomość jest usuwana przy użyciu ostatniego odebranego potwierdzenia wyskakującego, od Get Messages lub Update Message.

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

• 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 znaleziono komunikatu z pasującym potwierdzeniem wyskakującym, usługa zwraca kod błędu 404 (Nie znaleziono). Ten błąd występuje w poprzednio wymienionych przypadkach, w których potwierdzenie wyskakujące 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