Tabel verwijderen

  • Artikel

De Delete Table bewerking verwijdert de opgegeven tabel en alle gegevens die deze bevat.

Aanvraag

U kunt de Delete Table aanvraag als volgt samenstellen. HTTPS wordt aanbevolen. Vervang myaccount door de naam van uw opslagaccount en mytable door de naam van de tabel die moet worden verwijderd.

Methode Aanvraag-URI HTTP-versie
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

Geëmuleerde opslagservice-URI

Wanneer u een aanvraag maakt voor de geëmuleerde opslagservice, geeft u de hostnaam van de emulator en de Azure Table Storage-poort op als 127.0.0.1:10002, gevolgd door de naam van het geëmuleerde opslagaccount.

Methode Aanvraag-URI HTTP-versie
DELETE http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') HTTP/1.1

Table Storage in de geëmuleerde opslagservice verschilt op verschillende manieren van De Azure Table Storage. Zie Verschillen tussen de opslagemulator en Azure Storage-services voor meer informatie.

URI-parameters

Geen.

Aanvraagheaders

De aanvraag moet de Authorization header en de Date of-header x-ms-date bevatten, zoals opgegeven in Aanvragen voor Azure Storage autoriseren. Aanvullende headers worden beschreven in de volgende tabel.

Aanvraagheader Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
x-ms-version Optioneel. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
Content-Type Vereist. Hiermee geeft u het inhoudstype van de payload op. Mogelijke waarden zijn:

- application/atom+xml (alleen versies ouder dan 2015-12-11)
- application/json

Zie Payload-indeling voor Table Storage-bewerkingen voor meer informatie.
x-ms-client-request-id Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Table Storage bewaken voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 204 (Geen inhoud). Zie Status- en foutcodes enTable Storage-foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook extra, standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader Beschrijving
x-ms-request-id Deze header identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version Geeft de versie van Table Storage aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan op basis van versie 2009-09-19 en hoger.
Date Een UTC-datum/tijd-waarde die de tijd aangeeft waarop het antwoord is gestart. Deze service genereert deze waarde.
x-ms-client-request-id U kunt deze header gebruiken om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header, als deze aanwezig is in de aanvraag. De waarde is maximaal 1024 zichtbare ASCII-tekens. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Hoofdtekst van de reactie

Geen.

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

Wanneer u een tabel verwijdert, wordt deze onmiddellijk gemarkeerd voor verwijdering en is deze niet meer toegankelijk voor clients. De tabel wordt later tijdens de garbagecollection uit Table Storage verwijderd.

Houd er rekening mee dat het verwijderen van een tabel waarschijnlijk ten minste 40 seconden duurt. Als u een bewerking op de tabel probeert uit te voeren terwijl deze wordt verwijderd, retourneert de service statuscode 409 (Conflict). De service retourneert aanvullende foutinformatie die aangeeft dat de tabel wordt verwijderd.

Zie ook

Table Storage-foutcodes
De headers van de OData-gegevensserviceversie instellen
Aanvragen voor Azure Storage autoriseren
Status en foutcodes