Tábla törlése

  • Cikk

A Delete Table művelet törli a megadott táblát és a benne lévő adatokat.

Kérés

A kérést a Delete Table következőképpen hozhatja létre. A HTTPS használata ajánlott. Cserélje le a myaccount kifejezést a tárfiók nevére, a mytable értékét pedig a törölni kívánt tábla nevére.

Metódus Kérés URI-ja HTTP-verzió
DELETE https://myaccount.table.core.windows.net/Tables('mytable') HTTP/1.1

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/Tables('mytable') HTTP/1.1

A Table Storage az emulált tárolási szolgáltatásban többféleképpen különbözik az Azure Table Storage-tó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

Nincsenek.

Kérésfejlécek

A kérelemnek tartalmaznia kell a Authorization fejlécet és a x-ms-dateDate fejlécet az Azure Storage-ba irányuló kérések engedélyezése című témakörben leírtak szerint. A további fejléceket az alábbi táblázat 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.
Content-Type Kötelező. Megadja a hasznos adat tartalomtípusát. Lehetséges értékek:

- application/atom+xml (csak 2015-12-11 előtti verziók)
- application/json

További információ: A Table Storage-műveletek hasznos adatformátuma.
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 műveletre adott 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. Ez 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

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Ha sikeresen töröl egy táblát, az azonnal törlésre lesz megjelölve, és már nem érhető el az ügyfelek számára. A tábla később eltávolításra kerül a Table Storage-ból a szemétgyűjtés során.

Vegye figyelembe, hogy a táblák törlése valószínűleg legalább 40 másodpercet vesz igénybe. Ha egy műveletet kísérel meg a táblán a törlés közben, a szolgáltatás a 409-ben megadott állapotkódot (Ütközés) adja vissza. A szolgáltatás további hibainformációkat ad vissza, amelyek azt jelzik, hogy a tábla törölve van.

Lásd még

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