Usuwanie jednostki (Azure Storage)

Operacja Delete Entity usuwa istniejącą jednostkę w tabeli.

Żądanie

Żądanie można skonstruować Delete Entity w następujący sposób. Zalecane jest użycie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu, tabelą mytable nazwą tabeli, a myPartitionKey i myRowKey nazwą klucza partycji i klucza wiersza identyfikującą jednostkę do usunięcia.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey')	HTTP/1.1

Adres jednostki do zaktualizowania może mieć wiele formularzy w identyfikatorze URI żądania. Aby uzyskać dodatkowe informacje, zobacz protokół OData.

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 Table Storage jako 127.0.0.1:10002, a następnie nazwę emulowanego konta magazynu.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	http://127.0.0.1:10002/devstoreaccount1/myentity(PartitionKey='myPartitionKey', RowKey='myRowKey')	HTTP/1.1

Usługa Table Storage w emulatorze magazynu różni się od usługi platformy Azure na kilka sposobów. Aby uzyskać więcej informacji, zobacz Różnice między emulatorem magazynu i usługami Azure Storage.

Parametry identyfikatora URI

Dla identyfikatora URI żądania można określić następujący dodatkowy parametr.

Parametr	Opis
timeout	Opcjonalny. Parametr limitu czasu jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi Table 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.
If-Match	Wymagane. Klient może określić ETag wartość dla jednostki w żądaniu, aby porównać go z ETag obsługiwanym przez usługę celem optymistycznej współbieżności. Operacja usuwania jest kontynuowana tylko wtedy, gdy ETag wysyłany przez klienta jest zgodny z wartością obsługiwaną przez serwer. To dopasowanie oznacza, że jednostka nie została zmodyfikowana, ponieważ została pobrana przez klienta. Aby wymusić bezwarunkowe usunięcie, ustaw If-Match symbol wieloznaczny (*).
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 Table 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 oraz Kody błędów usługi Table Storage.

Nagłówki odpowiedzi

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

Nagłówek odpowiedzi	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 Table 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 służy do rozwiązywania problemów z żądaniami i odpowiadającymi im 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 jednostki jednostka zostanie natychmiast oznaczona do usunięcia i nie będzie już dostępna dla klientów. Jednostka zostanie później usunięta z usługi Table Storage podczas odzyskiwania pamięci.

ETag Jednostka zapewnia domyślną optymistyczną współbieżność dla operacji usuwania. Wartość ETag jest nieprzezroczysta i nie powinna być odczytywana ani polegana. Przed rozpoczęciem operacji usuwania usługa Table Storage sprawdza, czy bieżąca ETag wartość jednostki jest taka sama jak ETag wartość dołączona do żądania usunięcia w nagłówku If-Match . Jeśli wartości są identyczne, usługa Table Storage określa, że jednostka nie została zmodyfikowana od czasu jej pobrania, a operacja usuwania jest kontynuowana.

Jeśli jednostka ETag różni się od określonego w żądaniu usuwania, operacja usuwania kończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego). Ten błąd wskazuje, że jednostka została zmieniona na serwerze od czasu jej pobrania. Aby rozwiązać ten błąd, pobierz jednostkę ponownie i ponownie prześlij żądanie.

Aby wymusić bezwarunkową operację usuwania, ustaw wartość If-Match nagłówka na symbol wieloznaczny (*) na żądanie. Przekazanie tej wartości do operacji zastępuje domyślną optymistyczną współbieżność i ignoruje wszelkie niezgodności w ETag wartościach.

If-Match Jeśli w żądaniu brakuje nagłówka, usługa zwraca kod stanu 400 (Nieprawidłowe żądanie). Żądanie źle sformułowane na inne sposoby może również zwrócić kod 400. Aby uzyskać więcej informacji, zobacz Table Storage error codes (Kody błędów usługi Table Storage).

Każda aplikacja, która może autoryzować i wysyłać HTTP DELETE żądanie, może usunąć jednostkę. Aby uzyskać więcej informacji na temat konstruowania zapytania przy użyciu programu HTTP DELETE, zobacz Dodawanie, modyfikowanie i usuwanie jednostek.

Aby uzyskać informacje na temat wykonywania operacji usuwania wsadowego, zobacz Wykonywanie transakcji grupy jednostek.

Zobacz też

Autoryzowanie żądań do usługi Azure Storage
Ustawianie nagłówków wersji usługi danych OData
Kody stanu i błędów
Kody błędów usługi Table Storage