Usuwanie jednostki (Azure Storage)

  • Artykuł

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ącego 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 a usługami Azure Storage.

Parametry identyfikatora URI

W identyfikatorze 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 usług Azure Storage.
If-Match Wymagane. Klient może określić ETag dla jednostki w żądaniu, aby porównać je z ETag obsługiwanym przez usługę w celu optymistycznej współbieżności. Operacja usuwania jest wykonywana tylko wtedy, gdy ETag wysłany przez klienta jest zgodny z wartością obsługiwaną przez serwer. To dopasowanie wskazuje, że jednostka nie została zmodyfikowana, ponieważ została pobrana przez klienta.

Aby wymusić bezwarunkowe usunięcie, ustaw If-Match znak wieloznaczny (*).
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 Table 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 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 nagłówki standardowe 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 uruchamiania żą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 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 jednostki jednostka jest natychmiast oznaczona do usunięcia i nie jest już dostępna.

ETag Jednostka zapewnia domyślną optymistyczną współbieżność dla operacji usuwania. Wartość ETag jest nieprzezroczysta i nie powinna być odczytywana ani polegana. Przed wykonaniem 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, ponieważ została pobrana, a operacja usuwania będzie kontynuowana.

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

Aby wymusić bezwarunkową operację usuwania, ustaw wartość If-Match nagłówka na symbol wieloznaczny (*) w żądaniu. 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 w inny sposób 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 tworzenia zapytania przy użyciu elementu 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