Ta bort tabell

Åtgärden Delete Table tar bort den angivna tabellen och alla data som den innehåller.

Förfrågan

Du kan skapa begäran på Delete Table följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto och mytable med namnet på den tabell som ska tas bort.

Metod URI för förfrågan HTTP-version
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

Emulerad lagringstjänst-URI

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Azure Table Storage-porten som 127.0.0.1:10002, följt av namnet på det emulerade lagringskontot.

Metod URI för förfrågan HTTP-version
DELETE http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') HTTP/1.1

Table Storage i den emulerade lagringstjänsten skiljer sig från Azure Table Storage på flera sätt. Mer information finns i Skillnader mellan lagringsemulatorn och Azure Storage-tjänster.

URI-parametrar

Inga.

Begärandehuvuden

Begäran måste innehålla Authorization huvudet och antingen Datex-ms-date eller -huvudet, enligt vad som anges i Auktorisera begäranden till Azure Storage. Ytterligare rubriker beskrivs i följande tabell.

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Valfritt. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
Content-Type Krävs. Anger nyttolastens innehållstyp. Möjliga värden:

- application/atom+xml (versioner före 2015-12-11 endast)
- application/json

Mer information finns i Nyttolastformat för Table Storage-åtgärder.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Table Storage.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 204 (inget innehåll). Information om statuskoder finns i Status- och felkoder och Tabelllagringsfelkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik Description
x-ms-request-id Det här huvudet identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger vilken version av Table Storage som används för att köra begäran. Det här huvudet returneras för begäranden mot version 2009-09-19 och senare.
Date Ett UTC-datum/tid-värde som anger den tid då svaret initierades. Den här tjänsten genererar det här värdet.
x-ms-client-request-id Du kan använda det här huvudet för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet för x-ms-client-request-id huvudet, om det finns i begäran. Värdet är högst 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran visas inte det här huvudet i svaret.

Själva svaret

Inga.

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

När du har tagit bort en tabell markeras den omedelbart för borttagning och är inte längre tillgänglig för klienter. Tabellen tas senare bort från Table Storage under skräpinsamling.

Observera att det sannolikt tar minst 40 sekunder att ta bort en tabell. Om du försöker utföra en åtgärd mot tabellen när den tas bort returnerar tjänsten statuskoden 409 (konflikt). Tjänsten returnerar ytterligare felinformation som anger att tabellen tas bort.

Se även

Felkoder för Table Storage
Ange versionshuvuden för OData-datatjänsten
Auktorisera begäranden till Azure Storage
Status- och felkoder