Path - Delete

  • Referencia
Service:
Storage Services
API Version:
2023-08-03

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}
With optional parameters: 
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}

URI-paraméterek

Name In Kötelező Típus Description
accountName
 path True

string

Az Azure Storage-fiók neve.
dnsSuffix
 path True

string

A Azure Data Lake Storage végpont DNS-utótagja.
filesystem
 path True

string

A fájlrendszer azonosítója.

Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
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.

Headers

  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
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.

Headers

  • Date: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-continuation: string
Other Status Codes

DataLakeStorageError

Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:

  • 400 Bad Request, ContentLengthMustBeZero, "A Content-Length kérelem fejlécének nullának kell lennie."
  • 400 Bad Request, InvalidAuthenticationInfo, "A hitelesítési információk nem a megfelelő formátumban adhatók meg. Ellenőrizze az Engedélyezési fejléc értékét."
  • 400 Hibás kérelem, InvalidFlushPosition, "A feltöltött adatok nem folytonosak, vagy a pozíció lekérdezési paraméter értéke nem egyenlő a fájl hosszával a feltöltött adatok hozzáfűzése után."
  • 400 Bad Request, InvalidHeaderValue, "Az egyik HTTP-fejléc értéke nem a megfelelő formátumú."
  • 400 Hibás kérelem, ÉrvénytelenHttpVerb, "A megadott HTTP-parancs érvénytelen – a kiszolgáló nem ismeri fel."
  • 400 Hibás kérelem, InvalidInput, "Az egyik kérés bemenete érvénytelen."
  • 400 Hibás kérelem, InvalidPropertyName, "A tulajdonságnév nem lehet üres".
  • 400 Hibás kérelem, InvalidPropertyName, "A tulajdonságnév érvénytelen karaktereket tartalmaz."
  • 400 Hibás kérelem, InvalidQueryParameterValue, "A kérelem URI-jában megadott egyik lekérdezési paraméter értéke érvénytelen."
  • 400 Hibás kérelem, InvalidResourceName, "A megadott erőforrásnév érvénytelen karaktereket tartalmaz."
  • 400 Hibás kérelem, InvalidSourceUri, "A forrás URI érvénytelen."
  • 400 Hibás kérelem, InvalidUri, "A kérelem URI-ja érvénytelen."
  • 400 Bad Request, MissingRequiredHeader, "A kérelemhez kötelező HTTP-fejléc nincs megadva."
  • 400 Bad Request, MissingRequiredQueryParameter, "A kéréshez kötelező lekérdezési paraméter nincs megadva."
  • 400 Hibás kérés, MultipleConditionHeadersNotSupported, "Több feltételfejléc nem támogatott".
  • 400 Bad Request, OutOfRangeInput, "Az egyik kérés bemenete kívül esik a tartományon."
  • 400 Bad Request, OutOfRangeQueryParameterValue, "A kérelem URI-jában megadott egyik lekérdezési paraméter kívül esik a megengedett tartományon."
  • 400 Bad Request, UnsupportedHeader, "A kérelemben megadott fejlécek egyike nem támogatott."
  • 400 Hibás kérelem, Nem támogatottQueryParameter, "A kérelem URI-jában megadott egyik lekérdezési paraméter nem támogatott."
  • 400 Hibás kérés, Nem támogatottRestVersion, "A megadott rest verzió nem támogatott."
  • 403 Tiltott, AccountIsDisabled, "A megadott fiók le van tiltva."
  • 403 Tiltott, AuthorizationFailure: "Ez a kérés nem jogosult a művelet végrehajtására."
  • 403 Tiltott, InsufficientAccountPermissions: "A hozzáférés alatt álló fiók nem rendelkezik a művelet végrehajtásához szükséges engedélyekkel."
  • 404 Not Found, FilesystemNotFound, "A megadott fájlrendszer nem létezik."
  • 404 Nem található, PathNotFound: "A megadott elérési út nem létezik."
  • 404 Nem található, RenameDestinationParentPathNotFound, "A cél elérési út szülőkönyvtára nem létezik."
  • 404 Nem található, ResourceNotFound: "A megadott erőforrás nem létezik."
  • 404 Nem található, SourcePathNotFound: "Az átnevezési művelet forrásútvonala nem létezik."
  • 405 Method Not Allowed, UnsupportedHttpVerb, "Az erőforrás nem támogatja a megadott HTTP-parancsot."
  • 409 Conflict, DestinationPathIsBeingDeleted, "A megadott célútvonal törölendőként van megjelölve."
  • 409 Conflict, DirectoryNotEmpty, "A rekurzív lekérdezési paraméter értékének igaznak kell lennie egy nem üres könyvtár törléséhez."
  • 409 Conflict, FilesystemAlreadyExists, "A megadott fájlrendszer már létezik."
  • 409 Conflict, FilesystemBeingDeleted," "A megadott fájlrendszer törölve van."
  • 409 Conflict, InvalidDestinationPath, "A megadott elérési út vagy az elérési út egy eleme létezik, és az erőforrástípusa érvénytelen ehhez a művelethez." * 409 Conflict, InvalidFlushOperation, "Az erőforrást a Blob Service API hozta létre vagy módosította, és a Data Lake Storage Service API nem tudja írni."
  • 409 Conflict, InvalidRenameSourcePath, "A forráskönyvtár nem lehet ugyanaz, mint a célkönyvtár, és a cél nem lehet a forráskönyvtár alkönyvtára."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "A forrás- és célerőforrás-típusnak azonosnak kell lennie."
  • 409 Conflict, LeaseAlreadyPresent, "Már létezik bérlet."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation: "A megadott bérletazonosító nem egyezett meg az erőforrás bérletazonosítójával a megadott bérletművelettel."
  • 409 Conflict, LeaseIsAlreadyBroken, "A bérlet már megszakadt, és nem törhető újra."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired: "A bérletazonosító megfelelt, de a bérlet jelenleg törési állapotban van, és nem szerezhető be, amíg meg nem törik."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged: "A bérletazonosító megfelelt, de a bérlet jelenleg feltört állapotban van, és nem módosítható."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed: "A bérletazonosító megfelelt, de a bérlet explicit módon megszakadt, és nem újítható meg."
  • 409 Conflict, LeaseNameMismatch, "A megadott bérletnév nem egyezett meg a meglévő bérletnévvel."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation: "A bérletazonosító nincs jelen a megadott bérletművelettel."
  • 409 Conflict, PathAlreadyExists, "A megadott elérési út már létezik."
  • 409 Ütközés, PathConflict, "A megadott elérési út vagy az elérési út egy eleme létezik, és az erőforrástípusa érvénytelen ehhez a művelethez."
  • 409 Conflict, SourcePathIsBeingDeleted, "A megadott forrásútvonal törölve van".
  • 409 Conflict, ResourceTypeMismatch, "A kérelemben megadott erőforrástípus nem egyezik meg az erőforrás típusával."
  • 412 Az előfeltétel meghiúsult, ConditionNotMet, "A HTTP feltételes fejléc(ek) használatával megadott feltétel nem teljesül."
  • 412 Az előfeltétel meghiúsult, LeaseIdMismatch, "A megadott bérletazonosító nem egyezett meg az erőforrás bérletazonosítójával."
  • 412 Az előfeltétel meghiúsult, LeaseIdMissing: "Jelenleg bérlet van az erőforráson, és nincs megadva bérletazonosító a kérelemben."
  • 412 Az előfeltétel meghiúsult, LeaseNotPresent: "Jelenleg nincs bérlet az erőforráson."
  • 412 Az előfeltétel meghiúsult, LeaseLost, "A bérletazonosító meg lett adva, de az erőforrás bérlete lejárt."
  • 412 Az előfeltétel sikertelen, SourceConditionNotMet, "A HTTP feltételes fejléc(ek) használatával megadott forrásfeltétel nem teljesül."
  • 413 Request Entity Too Large, RequestBodyTooLarge: "A kérelemtörzs túl nagy, és meghaladja a megengedett maximális korlátot."
  • 416 A kért tartomány nem megfelelő, InvalidRange: "A megadott tartomány érvénytelen az erőforrás aktuális méretéhez."
  • 500 Belső kiszolgálóhiba, InternalError: "A kiszolgáló belső hibát észlelt. Próbálkozzon újra a kéréssel."
  • 500 Belső kiszolgálóhiba, OperationTimedOut: "A művelet nem hajtható végre a megengedett időn belül."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A kimenő forgalom túllépte a fiókkorlátot."
  • 503 A szolgáltatás nem érhető el, ServerBusy: "A bejövő forgalom túllépte a fiókkorlátot."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A másodpercenkénti műveletek túllépik a fiókkorlátot."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A kiszolgáló jelenleg nem tud kéréseket fogadni. Próbálkozzon újra a kéréssel."

Headers

  • x-ms-request-id: string
  • x-ms-version: string

Definíciók

Name Description
DataLakeStorageError
Error

A szolgáltatáshiba-válasz objektuma.

DataLakeStorageError

Name Típus Description
error

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.