Usuwanie tabeli

Operacja Delete Table usuwa określoną tabelę i wszystkie zawarte w nim dane.

Żądanie

Żądanie można skonstruować Delete Table w następujący sposób. Zalecane jest użycie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu i tabelą mytable nazwą tabeli, która ma zostać usunięta.

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

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/Tables('mytable') HTTP/1.1

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

Parametry identyfikatora URI

Brak.

Nagłówki żądań

Żądanie musi zawierać Authorization nagłówek i Date nagłówek lub x-ms-date , jak określono w sekcji Autoryzowanie żądań do usługi Azure Storage. Dodatkowe nagłówki opisano w poniższej tabeli.

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.
Content-Type Wymagane. Określa typ zawartości ładunku. Możliwe wartości:

- application/atom+xml (wersje wcześniejsze niż 2015-12-11)
- application/json

Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table 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 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ź na tę operację 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ź. Ta 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

Tylko właściciel konta może wywołać tę operację.

Uwagi

Po pomyślnym usunięciu tabeli zostanie ona natychmiast oznaczona do usunięcia i nie jest już dostępna dla klientów. Tabela zostanie później usunięta z usługi Table Storage podczas odzyskiwania pamięci.

Pamiętaj, że usunięcie tabeli może potrwać co najmniej 40 sekund. Jeśli spróbujesz wykonać operację względem tabeli podczas jej usunięcia, usługa zwróci kod stanu 409 (konflikt). Usługa zwraca dodatkowe informacje o błędzie wskazujące, że tabela jest usuwana.

Zobacz też

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