Usuń tabelę

Operacja Delete Table usuwa określoną tabelę i wszystkie zawarte w niej 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, a 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 i 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 temacie Autoryzowanie żądań do usługi Azure Storage. Dodatkowe nagłówki zostały opisane 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 dla 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. 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ź na tę operację 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ź. 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 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

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 będzie już dostępna.

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