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