Path - Delete
Fájl törlése | Címtár törlése
Törölje a fájlt vagy könyvtárat. Ez a művelet támogatja a feltételes HTTP-kéréseket. További információ: Feltételes fejlécek megadása Blob Service-műveletekhez.
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
Az Azure Storage-fiók neve. |
dns
|
path | True |
string |
A Azure Data Lake Storage végpont DNS-utótagja. |
filesystem
|
path | True |
string |
A fájlrendszer azonosítója. Reguláris kifejezési minta: |
path
|
path | True |
string |
A fájl vagy könyvtár elérési útja. |
continuation
|
query |
string |
Választható. Címtár törlésekor az egyes hívásokkal törölt elérési utak száma korlátozott. Ha a törölni kívánt elérési utak száma meghaladja ezt a korlátot, a rendszer egy folytatási jogkivonatot ad vissza ebben a válaszfejlécben. Ha egy folytatási jogkivonatot ad vissza a válaszban, azt a törlési művelet későbbi meghívásában kell megadni a címtár törlésének folytatásához. |
|
paginated
|
query |
boolean |
Nem kötelező és csak akkor érvényes, ha a fiók hierarchikus névtere engedélyezve van, és az erőforrás egy "rekurzív" lekérdezési paraméterrel rendelkező könyvtár, amely "true" (igaz) értékűre van állítva. Rekurzív címtártörlés esetén az egyes hívásokkal törölhető elérési utak száma korlátozott, ha a használt engedélyezési mechanizmus ACL, a hívó pedig nem szuperfelhasználó, mivel az alapértelmezett időtúllépés 30 másodperc. Ha a "lapszámozott" lekérdezési paraméter "igaz" értékre van állítva, a válaszfejléc tartalmazhat "x-ms-continuation" értéket, ha eléri a fenti korlátot. Az "x-ms-continuation" subsequnt kérésben való elküldése során a "lapszámozott" és a "rekurzív" lekérdezési paramétert "true" (igaz) értékre kell állítani. Ha a válasz nem tartalmaz "x-ms-continuation" szöveget, a rekurzív címtár törlése sikeres lesz. A címtár tényleges törlése csak az utolsó hívás során történik, az előzőekben a címtár alatti fájlok és könyvtárak kiszolgálójának ACL-ellenőrzése történik a rekurzív törléshez. |
|
recursive
|
query |
boolean |
Csak akkor kötelező és érvényes, ha az erőforrás könyvtár. Ha "igaz", a könyvtár alatti összes elérési út törlődik. Ha a "hamis" és a könyvtár nem üres, hiba történik. |
|
timeout
|
query |
integer int32 |
Nem kötelező művelet időtúllépési értéke másodpercben. Az időszak akkor kezdődik, amikor a kérést a szolgáltatás megkapja. Ha az időtúllépési érték a művelet befejeződése előtt eltelik, a művelet meghiúsul. |
Kérelem fejléce
Name | Kötelező | Típus | Description |
---|---|---|---|
x-ms-lease-id |
string |
Ha aktív bérlet van, meg kell adni a bérletazonosítót. Reguláris kifejezési minta: |
|
If-Match |
string |
Választható. ETag-érték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás ETagje megegyezik a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
If-None-Match |
string |
Választható. ETag-érték vagy speciális helyettesítő ("*") érték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás ETagje nem egyezik meg a megadott értékkel. Az ETaget idézőjelekben kell megadni. |
|
If-Modified-Since |
string |
Választható. Dátum- és időérték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás a megadott dátum és idő óta módosult. |
|
If-Unmodified-Since |
string |
Választható. Dátum- és időérték. Ezt a fejlécet csak akkor adja meg a művelet végrehajtásához, ha az erőforrás nem lett módosítva a megadott dátum és idő óta. |
|
x-ms-client-request-id |
string |
A hibaelhárítás és a korreláció elemzési naplóiban rögzített UUID. Reguláris kifejezési minta: |
|
x-ms-date |
string |
Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. Ez megosztott kulcs engedélyezése esetén szükséges. |
|
x-ms-version |
string |
A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Ez megosztott kulcs engedélyezése esetén szükséges. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A fájl törölve lett. Fejlécek
|
|
202 Accepted |
A törlési kérés csak akkor fogadható el, ha a hierarchikus névtér engedélyezve van a fiókhoz. Fejlécek
|
|
Other Status Codes |
Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:
Fejlécek
|
Definíciók
Name | Description |
---|---|
Data |
|
Error |
A szolgáltatáshiba-válasz objektuma. |
DataLakeStorageError
Name | Típus | Description |
---|---|---|
error |
A szolgáltatáshiba-válasz objektuma. |
Error
A szolgáltatáshiba-válasz objektuma.
Name | Típus | Description |
---|---|---|
code |
string |
A szolgáltatás hibakódja. |
message |
string |
A szolgáltatás hibaüzenete. |