Megosztás a következőn keresztül:

Entitás törlése (Azure Storage)

  • Cikk

A Delete Entity művelet egy tábla egy meglévő entitását törli.

Kérés

A kérést a Delete Entity következőképpen hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount értékét a tárfiók nevére, a mytable értékét a tábla nevére, a myPartitionKey és a myRowKey értékét pedig a törölni kívánt entitást azonosító partíciókulcs és sorkulcs nevére.

Metódus Kérés URI-ja HTTP-verzió
DELETE https://myaccount.table.core.windows.net/mytable(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

A frissíteni kívánt entitás címe számos űrlapot tartalmazhat a kérelem URI-ján. További részletekért lásd az OData-protokollt.

Emulált tárolási szolgáltatás URI-ja

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és az Azure Table Storage-portot 127.0.0.1:10002, majd az emulált tárfiók nevét.

Metódus Kérés URI-ja HTTP-verzió
DELETE http://127.0.0.1:10002/devstoreaccount1/myentity(PartitionKey='myPartitionKey', RowKey='myRowKey') HTTP/1.1

A Tárolóemulátor Table Storage szolgáltatása többféleképpen különbözik az Azure-szolgáltatástól. További információ: A táremulátor és az Azure Storage-szolgáltatások közötti különbségek.

URI-paraméterek

A kérelem URI-ja a következő további paramétert adhatja meg.

Paraméter Leírás
timeout Választható. Az időtúllépési paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása a Table Storage-műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce Leírás
Authorization Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
Date vagy x-ms-date Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba.
x-ms-version Választható. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
If-Match Kötelező. Az ügyfél megadhatja az ETag entitást a kérelemben, hogy összehasonlíthassa a ETag szolgáltatás által fenntartottval az optimista egyidejűség érdekében. A törlési művelet csak akkor folytatódik, ha az ETag ügyfél által küldött érték megegyezik a kiszolgáló által kezelt értékkel. Ez az egyezés azt jelzi, hogy az entitást nem módosították, mióta az ügyfél lekérte.

Feltétel nélküli törlés kényszerítéséhez állítsa If-Match be a helyettesítő karaktert (*).
x-ms-client-request-id Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Az Azure Table Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.

Állapotkód

A sikeres művelet a 204-ben (tartalom nélkül) visszaadott állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok és Table Storage-hibakódok.

Válaszfejlécek

A válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc Description
x-ms-request-id Ez a fejléc egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A Table Storage kérés futtatásához használt verzióját jelzi. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es és újabb verzióval kapcsolatos kérésekhez.
Date Utc dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket.
x-ms-client-request-id Ezzel a fejlécmel elháríthatja a kéréseket és a megfelelő válaszokat. A fejléc értéke megegyezik a fejléc értékével x-ms-client-request-id , ha az szerepel a kérelemben. Az érték legfeljebb 1024 látható ASCII-karakter lehet. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor ez a fejléc nem jelenik meg a válaszban.

Választörzs

Nincsenek.

Engedélyezés

A fióktulajdonos végrehajthatja ezt a műveletet. Emellett bárki, aki rendelkezik a művelet végrehajtásához engedéllyel rendelkező közös hozzáférésű jogosultsággal, végrehajthatja azt.

Megjegyzések

Ha sikeresen töröl egy entitást, az entitás azonnal törlésre lesz megjelölve, és már nem érhető el.

Az entitások ETag alapértelmezett optimista egyidejűséget biztosítanak a törlési műveletekhez. Az ETag érték átlátszatlan, ezért nem szabad olvasni vagy támaszkodni rá. A törlési művelet előtt a Table Storage ellenőrzi, hogy az entitás aktuális ETag értéke megegyezik-e a ETag fejléc törlési kérésében If-Match szereplő értékkel. Ha az értékek azonosak, a Table Storage megállapítja, hogy az entitás nem lett módosítva a lekérése óta, és a törlési művelet folytatódik.

Ha az entitások ETag eltérnek a törlési kérelemben megadotttól, a törlési művelet a 412-s állapotkóddal meghiúsul (az előfeltétel sikertelen). Ez a hiba azt jelzi, hogy az entitás a lekérése óta módosult a kiszolgálón. A hiba megoldásához kérje le újra az entitást, és adja ki újra a kérést.

Feltétel nélküli törlési művelet kényszerítéséhez állítsa a If-Match fejléc értékét a kérelem helyettesítő karakterére (*). Ha ezt az értéket átadja a műveletnek, felülbírálja az alapértelmezett optimista egyidejűséget, és figyelmen kívül hagyja az ETag értékek eltéréseit.

Ha a If-Match fejléc hiányzik a kérelemből, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). A más módon helytelenül formázott kérések a 400-ás kódot is visszaadhatják. További információ: Table Storage hibakódok.

Bármely alkalmazás, amely engedélyezheti és elküldheti a kérést HTTP DELETE , törölheti az entitásokat. További információ a lekérdezések a használatával HTTP DELETEtörténő felépítéséről: Entitások hozzáadása, módosítása és törlése.

A kötegelt törlési műveletek végrehajtásával kapcsolatos információkért lásd: Entitáscsoport-tranzakciók végrehajtása.

Lásd még

Kérések engedélyezése az Azure Storage-ba
Az OData adatszolgáltatás verziófejléceinek beállítása
Állapot- és hibakódok
Table Storage-hibakódok