Ta bort entitet (Azure Storage)

Åtgärden Delete Entity tar bort en befintlig entitet i en tabell.

Förfrågan

Du kan skapa begäran på Delete Entity följande sätt. HTTPS rekommenderas. Ersätt myaccount med namnet på ditt lagringskonto, mytable med namnet på tabellen och myPartitionKey och myRowKey med namnet på partitionsnyckeln och radnyckeln som identifierar entiteten som ska tas bort.

Metod	URI för förfrågan	HTTP-version
DELETE	https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey')	HTTP/1.1

Adressen till den entitet som ska uppdateras kan ha ett antal formulär på begärande-URI:n. Mer information finns i OData Protocol.

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/myentity(PartitionKey='myPartitionKey', RowKey='myRowKey')	HTTP/1.1

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

URI-parametrar

Du kan ange följande ytterligare parameter i begärande-URI:n.

Parameter	Beskrivning
timeout	Valfritt. Tidsgränsparametern uttrycks i sekunder. Mer information finns i Ange tidsgränser för Table Storage-åtgärder.

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

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.
If-Match	Krävs. Klienten kan ange ETag för entiteten på begäran, så att den kan jämföras med tjänstens ETag underhåll för optimistisk samtidighet. Borttagningsåtgärden fortsätter endast om den ETag som skickas av klienten matchar värdet som upprätthålls av servern. Den här matchningen anger att entiteten inte har ändrats sedan den hämtades av klienten. Om du vill framtvinga en ovillkorlig borttagning anger du If-Match jokertecknet (*).
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 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. 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

Kontoägaren kan utföra den här åtgärden. Dessutom kan alla med en signatur för delad åtkomst som har behörighet att utföra den här åtgärden utföra den.

Kommentarer

När du har tagit bort en entitet markeras entiteten omedelbart för borttagning och är inte längre tillgänglig.

En entitet ger ETag standardoptim samtidighet för borttagningsåtgärder. Värdet ETag är ogenomskinlig och bör inte läsas eller användas. Innan en borttagningsåtgärd inträffar verifierar Table Storage att entitetens aktuella ETag värde är identiskt med värdet ETag som ingår i borttagningsbegäran i If-Match huvudet. Om värdena är identiska avgör Table Storage att entiteten inte har ändrats sedan den hämtades och borttagningsåtgärden fortsätter.

Om entiteten skiljer sig från den som angetts ETag med borttagningsbegäran misslyckas borttagningsåtgärden med statuskoden 412 (villkoret misslyckades). Det här felet anger att entiteten har ändrats på servern sedan den hämtades. Lös det här felet genom att hämta entiteten igen och skicka begäran igen.

Om du vill framtvinga en ovillkorlig borttagningsåtgärd anger du värdet If-Match för rubriken till jokertecknet (*) i begäran. Om du skickar det här värdet till åtgärden åsidosätts standardoptim samtidighet och eventuella felmatchningar i ETag värden ignoreras.

If-Match Om rubriken saknas i begäran returnerar tjänsten statuskoden 400 (felaktig begäran). En begäran som är felaktig på andra sätt kan också returnera kod 400. Mer information finns i Felkoder för Table Storage.

Alla program som kan auktorisera och skicka en HTTP DELETE begäran kan ta bort en entitet. Mer information om hur du skapar en fråga med hjälp av finns HTTP DELETEi Lägga till, ändra och ta bort entiteter.

Information om hur du utför batchborttagningsåtgärder finns i Utföra entitetsgrupptransaktioner.

Se även

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