Usuwanie tabeli

Operacja Delete Table usuwa określoną tabelę i wszystkie dane, które zawiera.

Żądanie

Żądanie Delete Table może zostać skonstruowane w następujący sposób. Protokół HTTPS jest zalecany. Zastąp myaccount nazwą konta magazynu, a mytable nazwą tabeli do usunięcia:

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

Emulowany adres URI usługi magazynu

Podczas tworzenia żądania względem emulowanej usługi magazynu określ nazwę hosta emulatora i port usługi table jako , a następnie 127.0.0.1:10002 nazwę emulowanej 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 Service w emulowanej usłudze magazynu różni się Windows® azure™ Table na kilka sposobów. Aby uzyskać więcej informacji, zobacz Differences Between the Storage Emulator and Azure Storage Services (Różnice między usługami Azure Storage Emulator i Azure Storage Services).

Parametry URI

Brak.

Nagłówki żądań

Żądanie musi zawierać nagłówek i nagłówek lub , jak określono w sekcji Authorization Date x-ms-date 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 Versioning for the Azure Storage Services(Wersje usług Azure Storage Services).
Content-Type Wymagane. Określa typ zawartości ładunku. Możliwe wartości:

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

Aby uzyskać więcej informacji, zobacz Format ładunku dla operacji usługi Table Service.
x-ms-client-request-id Opcjonalny. Zapewnia wygenerowaną przez klienta nieprzezroczystą wartość z limitem znaków 1 KiB, który jest rejestrowany w dziennikach analizy, gdy jest włączone rejestrowanie analizy magazynu. Używanie tego nagłówka jest wysoce zalecane do korelowania działań po stronie klienta z żądaniami odebranymi przez serwer. Aby uzyskać więcej informacji, zobacz About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (Informacje o rejestrowaniu analizy danych i rejestrowaniu na platformie Azure: używanie dzienników do śledzenia żądań Storage danych).

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 tabel.

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 unikatowo identyfikuje żądanie, które zostało wykonane, i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Troubleshooting API Operations (Rozwiązywanie problemów z operacjami interfejsu API).
x-ms-version Wskazuje wersję usługi Table Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań względem wersji 2009-09-19 i nowszych.
Date Wartość daty/czasu UTC wygenerowana przez usługę, która wskazuje czas, o której została zainicjowana odpowiedź.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny 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 tabela jest natychmiast oznaczana do usunięcia i nie jest już dostępna dla klientów. Tabela zostanie później usunięta z usługi Table Service podczas wyrzucania elementów bezużytecznych.

Pamiętaj, że usunięcie tabeli może potrwać co najmniej 40 sekund. Jeśli podjęto próbę operacji względem tabeli podczas jej usunięcia, usługa zwraca kod stanu 409 (Konflikt), z dodatkowymi informacjami o błędzie wskazującymi, że tabela jest usuwana.

Zobacz też

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