Path - Update

Service:

Storage Services

API Version:

2023-08-03

Adatok hozzáfűzése | Adatok kiürítése | Tulajdonságok beállítása | Access Control beállítása
Feltölti a fájlhoz hozzáfűzendő adatokat, kiüríti (írja) a korábban feltöltött adatokat egy fájlba, beállítja egy fájl vagy könyvtár tulajdonságait, vagy beállítja egy fájl vagy könyvtár hozzáférés-vezérlését. Az adatok csak fájlhoz fűzhetők. Az ugyanazon fájlba több ügyféllel történő egyidejű írás nem támogatott. Ez a művelet támogatja a feltételes HTTP-kéréseket. További információ: Feltételes fejlécek megadása blobszolgáltatás-műveletekhez.

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}

With optional parameters:

PATCH https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&position={position}&retainUncommittedData={retainUncommittedData}&close={close}&mode={mode}&maxRecords={maxRecords}&forceFlag={forceFlag}&continuation={continuation}&flush={flush}&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.
action	query	True	PathUpdateAction	A műveletnek hozzá kell fűznie a fájlhoz hozzáfűzendő adatok feltöltéséhez, a "flush" művelettel kiürítheti a korábban feltöltött adatokat egy fájlba, a "setProperties" parancsot a fájl vagy könyvtár tulajdonságainak beállításához, a "setAccessControl" pedig a fájl vagy könyvtár tulajdonosának, csoportjának, engedélyeinek vagy hozzáférés-vezérlési listájának beállításához, a "setAccessControlRecursive" pedig a címtárak hozzáférés-vezérlési listájának rekurzív beállításához. Vegye figyelembe, hogy a hozzáférés-vezérlés használatához engedélyezni kell a hierarchikus névteret a fiókhoz. Azt is vegye figyelembe, hogy a Access Control lista (ACL) tartalmazza a tulajdonos, a tulajdonoscsoport és mások engedélyeit, így az x-ms-permissions és az x-ms-acl kérelemfejlécek kölcsönösen kizárják egymást.
close	query		boolean	Az Azure Storage-események lehetővé teszik az alkalmazások számára, hogy értesítéseket kapjanak a fájlok módosításakor. Ha az Azure Storage-események engedélyezve vannak, a rendszer fájlmódosítási eseményt hoz létre. Ennek az eseménynek van egy tulajdonsága, amely azt jelzi, hogy ez-e az utolsó változás, amely különbséget tesz a köztes kiürítés és a fájlstream végső lezárása között. A bezárt lekérdezési paraméter csak akkor érvényes, ha a művelet "kiürítés" és a változásértesítések engedélyezve vannak. Ha a bezárás értéke "igaz", és a kiürítési művelet sikeresen befejeződött, a szolgáltatás fájlmódosítási értesítést küld egy tulajdonsággal, amely azt jelzi, hogy ez a végleges frissítés (a fájlstream lezárult). Ha "false" (hamis) változásértesítés jelenik meg, amely jelzi, hogy a fájl megváltozott. Az alapértelmezett érték hamis. Ezt a lekérdezési paramétert a Hadoop ABFS-illesztő igaz értékre állítja, jelezve, hogy a fájlstream bezárult."
continuation	query		string	Nem kötelező és csak a "setAccessControlRecursive" műveletre érvényes. Az egyes hívásokkal feldolgozott elérési utak száma korlátozott. Ha a feldolgozandó elérési utak száma meghaladja ezt a korlátot, a rendszer egy folytatási jogkivonatot ad vissza az x-ms-continuation válaszfejlécben. Ha egy folytatási jogkivonatot ad vissza a válaszban, százalékban kódoltnak kell lennie, és meg kell adnia a setAccessControlRecursive művelet későbbi meghívásában.
flush	query		boolean	Csak hozzáfűző hívásokhoz érvényes. Ez a paraméter lehetővé teszi, hogy a hívó kiürítsen egy hozzáfűzési hívás során. Az alapértelmezett érték a "false" (hamis), ha "igaz", akkor az adatok a hozzáfűző hívással lesznek kiürítve. Vegye figyelembe, hogy a flush=true használatakor a következő fejlécek nem támogatottak: "x-ms-cache-control", "x-ms-content-encoding", "x-ms-content-type", "x-ms-content-language", "x-ms-content-md5", "x-ms-content-disposition". A fejlécek kiürítés közbeni beállításához használja az action=flush parancsot.
forceFlag	query		boolean	Nem kötelező és csak a "setAccessControlRecursive" műveletre érvényes. Ha ez a "hamis" művelet gyorsan leáll a felhasználói hibák (4XX) észlelésekor. Ha "true" (igaz) az API figyelmen kívül hagyja a felhasználói hibákat, és folytatja a műveletet a címtár más alentitásainál. A felhasználói hibák részletes állapotát a rendszer mindkét forgatókönyv esetében visszaadja a válaszban. A folytatási jogkivonat csak akkor lesz visszaadva, ha a forceFlag "igaz" felhasználói hibák esetén. A forceFlag alapértelmezett értéke hamis.
maxRecords	query		integer int32	Nem kötelező és csak a "setAccessControlRecursive" műveletre érvényes. Meghatározza azoknak a fájloknak vagy könyvtáraknak a maximális számát, amelyekre az acl-módosítást alkalmazni fogják. Ha nincs megadva vagy nagyobb, mint 2000, a kérés legfeljebb 2000 elemet fog feldolgozni
mode	query		string	Választható. Érvényes és kötelező a "setAccessControlRecursive" művelethez. A "set" mód beállítja a POSIX hozzáférés-vezérlési jogosultságokat a fájlokon és könyvtárakon, a "módosítás" módosítja a fájlokon és könyvtárakon korábban meglévő POSIX-hozzáférés-vezérlési jogosultságokat, az "eltávolítás" eltávolít egy vagy több OLYAN POSIX-hozzáférés-vezérlési jogosultságot, amely korábban a fájlokon és könyvtárakon volt jelen
position	query		integer int64	Ez a paraméter lehetővé teszi, hogy a hívó párhuzamosan töltse fel az adatokat, és szabályozza a fájlhoz való hozzáfűzés sorrendjét. A fájlhoz hozzáfűzendő adatok feltöltésekor és a korábban feltöltött adatok fájlba való kiürítésekor szükséges. Az értéknek azt a pozíciót kell megadnia, ahol az adatokat hozzá kell fűzni. A feltöltött adatok nem lesznek azonnal kiürítve vagy megírva a fájlba. A kiürítéshez a korábban feltöltött adatoknak egybefüggőnek kell lenniük, a pozícióparamétert meg kell adni, és meg kell egyeznie a fájl hosszával az összes adat megírása után, és nem lehet kérelem entitástörzse a kérelemben.
retainUncommittedData	query		boolean	Csak kiürítési műveletekre érvényes. Ha "igaz", a kiürítési művelet befejeződése után a nem véglegesített adatok megmaradnak; ellenkező esetben a kiürítési művelet után a nem véglegesített adatok törlődnek. Az alapértelmezett érték hamis. A megadott pozíciónál kisebb eltolású adatokat a rendszer a fájlba írja, ha a kiürítés sikeres, de ez az opcionális paraméter lehetővé teszi, hogy a kiürítési pozíció utáni adatok megmaradjanak egy későbbi kiürítési művelethez.
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

Media Types: "application/octet-stream", "text/plain"

Name	Kötelező	Típus	Description
Content-Length		integer int64	Az "Adatok hozzáfűzése" és az "Adatok kiürítése" elemhez szükséges. "Adatok kiürítése" esetén 0-nak kell lennie. A kérelem tartalmának bájtban kell lennie az "Adatok hozzáfűzése" mezőben.
Content-MD5		string	Választható. A kérelem tartalmának MD5-kivonata. Ez a fejléc érvényes a "Hozzáfűzés" és a "Kiürítés" műveletekhez. Ez a kivonat a kérelem tartalmának integritásának ellenőrzésére szolgál az átvitel során. Ha ez a fejléc meg van adva, a tárolási szolgáltatás összehasonlítja az ezzel a fejlécértékkel érkezett tartalom kivonatát. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul. Vegye figyelembe, hogy ez az MD5-kivonat nem a fájllal együtt van tárolva. Ez a fejléc a kérelem tartalmához van társítva, és nem magához a fájlhoz tartozó tárolt tartalommal.
x-ms-lease-id		string	Ha aktív bérlet van, meg kell adni a bérletazonosítót. A "setAccessControlRecursive" műveletek esetében érvénytelen. Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-cache-control		string	Nem kötelező, és csak a kiürítési és beállítási tulajdonságokhoz érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Gyorsítótár-vezérlés" válaszfejlécében.
x-ms-content-type		string	Nem kötelező, és csak a kiürítési és beállítási tulajdonságokhoz érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Type" válaszfejlécében.
x-ms-content-disposition		string	Nem kötelező, és csak a kiürítési és beállítási tulajdonságokhoz érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécében.
x-ms-content-encoding		string	Nem kötelező, és csak a kiürítési és beállítási tulajdonságokhoz érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Encoding" válaszfejlécében.
x-ms-content-language		string	Nem kötelező, és csak a kiürítési és beállítási tulajdonságokhoz érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza azt a "Fájl olvasása" műveletek "Content-Language" válaszfejlécében.
x-ms-content-md5		string	Nem kötelező, és csak a "Tulajdonságok kiürítése és beállítása" műveletekhez érvényes. A szolgáltatás tárolja ezt az értéket, és a "Tulajdonságok olvasása és lekérése" műveletek "Content-Md5" válaszfejlécében tárolja. Ha ez a tulajdonság nincs megadva a kérelemben, akkor a tulajdonság törlődik a fájlhoz. Az "Olvasás és tulajdonságok lekérése" további hívásai csak akkor adják vissza ezt a tulajdonságot, ha explicit módon újra be van állítva a fájlon.
x-ms-properties		string	Választható. A fájllal vagy könyvtárral együtt tárolandó felhasználó által definiált tulajdonságok az "n1=v1, n2=v2, ..." név- és értékpárok vesszővel tagolt listájának formátumában, ahol minden érték egy base64 kódolású sztring. Vegye figyelembe, hogy a sztring csak ASCII-karaktereket tartalmazhat az ISO-8859-1 karakterkészletben. Csak a setProperties műveletre érvényes. Ha a fájl vagy könyvtár létezik, a listában nem szereplő tulajdonságok el lesznek távolítva. A fejléc kihagyása esetén az összes tulajdonság el lesz távolítva. Új és meglévő tulajdonságok egyesítéséhez először kérje le az összes meglévő tulajdonságot és az aktuális E-címkét, majd küldjön feltételes kérést az E-címkével, és adja meg az összes tulajdonság értékeit.
x-ms-owner		string	Nem kötelező, és csak a setAccessControl művelethez érvényes. Beállítja a fájl vagy könyvtár tulajdonosát.
x-ms-group		string	Nem kötelező, és csak a setAccessControl művelethez érvényes. Beállítja a fájl vagy könyvtár tulajdonoscsoportját.
x-ms-permissions		string	Nem kötelező, és csak akkor érvényes, ha a fiókhoz engedélyezve van a hierarchikus névtér. BEÁLLÍTJA a POSIX hozzáférési engedélyeit a fájl tulajdonosának, a fájltulajdonosi csoportnak és másoknak. Minden osztály kaphat olvasási (4), írási (2) vagy végrehajtási (1) engedélyt. Mind a szimbolikus (rwxrw-rw-) és a négyjegyű oktális jelölés (pl. 0766) támogatott. A ragadós bit is támogatott, és szimbolikus jelöléssel is rendelkezik, amelyet a t vagy a T betű jelöl a végső karakter-helyen attól függően, hogy a többi kategória végrehajtási bitje be van-e állítva, vagy nincs-e megadva (pl. rwxrw-rw - a cetlik bittel rwxrw-rwT. A ragadós bitet tartalmazó rwxrw-rwx rwx rwxrw-rwt, a t vagy a T hiánya azt jelzi, hogy a beragadó bit nincs beállítva. A négyjegyű oktális jelölésben az 1. számjegy jelenik meg (például az 1766 az rwxrw-rw-t jelöli ragadós bittel, a 0766 pedig az rwxrw-rw- cetlik nélkül). Az x-ms-acl fájllal együtt érvénytelen.
x-ms-acl		string	Nem kötelező, és csak a setAccessControl és a setAccessControlRecursive műveletekre érvényes. A setAccessControlRecursive művelethez szükséges. Beállítja a POSIX hozzáférés-vezérlési jogosultságokat a fájlokhoz és könyvtárakhoz. Az érték a hozzáférés-vezérlési bejegyzések vesszővel tagolt listája, amely teljes mértékben lecseréli a meglévő hozzáférés-vezérlési listát (ACL) a setAccessControl és a setAccessControlRecursive "set" üzemmódja esetén. A setAccessControlRecursive "modify" módja frissíti a már meglévő ACLS-t. Minden hozzáférés-vezérlési bejegyzés (ACE) egy hatókörből, egy típusból, egy felhasználó- vagy csoportazonosítóból és "[scope:][type]:[id]:[permissions]" formátumú engedélyekből áll. A hatókörnek "alapértelmezettnek" kell lennie annak jelzéséhez, hogy az ACE egy könyvtár alapértelmezett ACL-éhez tartozik; ellenkező esetben a hatókör implicit, és az ACE a hozzáférési ACL-hez tartozik. Négy ACE-típus létezik: a "felhasználó" jogokat ad a tulajdonosnak vagy egy megnevezett felhasználónak, a "csoport" a tulajdonoscsoportnak vagy egy nevesített csoportnak ad jogosultságokat, a "maszk" korlátozza a megnevezett felhasználók és a csoportok tagjai számára biztosított jogokat, az "egyéb" pedig a többi bejegyzésben nem szereplő összes felhasználónak biztosít jogosultságokat. A felhasználó- vagy csoportazonosító nem szerepel a "maszk" és az "egyéb" típusú bejegyzéseknél. A tulajdonos és a tulajdonos csoport felhasználó- vagy csoportazonosítója is hiányzik. Az engedélymező egy 3 karakterből álló sorozat, amelyben az első karakter "r" az olvasási hozzáférés biztosításához, a második karakter a "w" az írási hozzáférés megadásához, a harmadik karakter pedig az "x" a végrehajtási engedély megadásához. Ha a hozzáférés nincs megadva, a "-" karakter azt jelzi, hogy az engedély megtagadva. A következő ACL például olvasási, írási és végrehajtási jogokat biztosít a fájl tulajdonosának és john.doe@contoso, a tulajdonosi csoporthoz való olvasási jogot, és semmi mást: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Az x-ms-permissions beállítással együtt érvénytelen. A setAccessControlRecursive "remove" módja eltávolítja a már meglévő ACL-eket, és nem tartalmazhat engedélyeket a következő megadott hozzáférés-vezérlési listában: "user:john.doe@contoso:, mask:". A setAccessControlRecursive "set" üzemmódja beállítja a megadott hatókör meglévő ACL-jei helyett az ACL-eket, és tartalmaznia kell mind a háromat – a tulajdonos felhasználót, a tulajdonoscsoportot és egyéb adatokat, ha a hozzáférési hatókör be van állítva, vagy ha a tulajdonos felhasználó, tulajdonoscsoport vagy egyéb felhasználó van beállítva az alapértelmezett hatókörben. A setAccessControlRecursive "set" és "modify" módjainak engedélyeket kell tartalmazniuk a hozzáférés-vezérlési lista részeként.
If-Match		string	Nem kötelező az Adatok kiürítése, a Access Control beállítása és a Tulajdonságok beállítása, de érvénytelen az Adatok hozzáfűzése és a Access Control rekurzív beállítása esetén. Egy ETag érték. Adja meg ezt a fejlécet a művelet végrehajtásához, ha az erőforrás ETagje megegyezik a megadott értékkel. Az ETaget idézőjelek között kell megadni.
If-None-Match		string	Nem kötelező az Adatok kiürítése, a Access Control beállítása és a Tulajdonságok beállítása, de érvénytelen az Adatok hozzáfűzése és a Access Control rekurzív beállítása esetén. ETag-érték vagy speciális helyettesítő karakter ("*") é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őjelek között kell megadni.
If-Modified-Since		string	Nem kötelező az Adatok kiürítése és a Tulajdonságok beállítása beállításnál, de az Adatok hozzáfűzése és a Access Control rekurzív beállítása esetén érvénytelen. Egy 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	Nem kötelező az Adatok kiürítése és a Tulajdonságok beállítása beállításnál, de az Adatok hozzáfűzése és a Access Control rekurzív beállítása esetén érvénytelen. Egy 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-encryption-key		string	Választható. A Base64 kódolású AES-256 titkosítási kulcs.
x-ms-encryption-key-sha256		string	Választható. A titkosítási kulcs Base64 kódolású SHA256 kivonata.
x-ms-encryption-algorithm: AES256		string	Választható. Megadja a titkosításhoz használandó algoritmust. A fejléc értékének AES256-nak kell lennie.
x-ms-lease-action	True	PathLeaseAction	A 2020-08-04-es verziótól kezdve a hozzáfűzési és kiürítési műveletekben. A Hozzáfűzés támogatja a "acquire", az "auto-renew" és a "acquire-release" műveletet. Ha "megszerzi" a bérletet, az megszerzi a bérletet. Ha az "automatikus megújítás" megújul a bérletet. Ha a "acquire-release" megszerzi a műveletet, & végrehajtja a műveletet, & a művelet befejezése után felszabadítja a bérletet. A "Release" művelet csak a kiürítési műveletben támogatott. Ha "igaz", akkor a bérletet az x-ms-lease-id fejlécből származó bérletazonosító-adatok használatával adja ki a fájlban.
x-ms-lease-duration		integer int32	A bérlet megszerzéséhez a bérlet időtartama szükséges, és a bérlet időtartamát másodpercben határozza meg. A bérlet időtartamának 15 és 60 másodperc, végtelen bérlet esetén pedig -1 között kell lennie.
x-ms-proposed-lease-id		string	Akkor szükséges, ha az "x-ms-lease-action" "acquire" vagy "change" típusú. Ha a művelet sikeres, a rendszer ezzel a bérletazonosítóval szerez be egy bérletet. Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-client-request-id		string	Az elemzési naplókban a hibaelhárításhoz és a korrelációhoz 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. Erre megosztott kulcs engedélyezésekor van szükség.
x-ms-version		string	A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Erre megosztott kulcs engedélyezésekor van szükség.

Kérelem törzse

Media Types: "application/octet-stream", "text/plain"

Name	Típus	Description
requestBody	object	Csak hozzáfűzési műveletekhez érvényes. A feltöltendő és a fájlhoz hozzáfűzendő adatok.

Válaszok

Name	Típus	Description
200 OK	SetAccessControlRecursiveResponse	Az adatokat kiürítették (megírták) a fájlba, vagy a tulajdonságokat sikeresen beállították. A választörzs nem kötelező, és csak a "SetAccessControlRecursive" esetében érvényes Headers Date: string ETag: string Last-Modified: string Accept-Ranges: string Cache-Control: string Content-Disposition: string Content-Encoding: string Content-Language: string Content-Length: integer Content-Range: string Content-Type: string Content-MD5: string x-ms-properties: string x-ms-continuation: string x-ms-request-id: string x-ms-version: string x-ms-request-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-scope: string x-ms-lease-renewed: boolean
202 Accepted		A feltöltött adatok el lett fogadva. Headers Content-MD5: string Date: string x-ms-request-id: string x-ms-version: string x-ms-lease-renewed: boolean
Other Status Codes	DataLakeStorageError	Hiba történt. A lehetséges HTTP-állapotok, -kód- és üzenetsztringek az alábbiakban láthatók: 400 Bad Request, ContentLengthMustBeZero, "A Content-Length kérés fejlécének nullának kell lennie." 400 Bad Request, InvalidAuthenticationInfo, "A hitelesítési adatok nem a megfelelő formátumban adhatók meg. Ellenőrizze az Engedélyezési fejléc értékét." 400 Bad Request, 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érés, ÉrvénytelenHttpVerb, "A megadott HTTP-parancs érvénytelen – a kiszolgáló nem ismeri fel." 400 Bad Request, InvalidInput, "Az egyik kérés bemenete érvénytelen." 400 Bad Request, InvalidPropertyName, "A tulajdonságnév nem lehet üres." 400 Bad Request, InvalidPropertyName, "A tulajdonságnév érvénytelen karaktereket tartalmaz." 400 Bad Request, InvalidQueryParameterValue, "A kérelem URI-jában megadott lekérdezési paraméterek egyikének é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éréshez 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 Bad Request, UnsupportedQueryParameter, "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érelem 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 Nem található, 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útvonal 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 a cél erőforrástípusának 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ő meg újra." 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "A bérletazonosító megfelelt, de a bérlet jelenleg kompatibilitástörő állapotban van, és nem szerezhető be, amíg meg nem törik." 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "A bérlet azonosítója megfelelt, de a bérlet jelenleg kompatibilitástörő á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ölendőként van megjelölve." 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 sikertelen, 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 nem adott meg bérletazonosító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 Internal Server Error, 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 A szolgáltatás nem érhető el, ServerBusy, "A kimenő forgalom túllépte a fiók korlátját". 503 A szolgáltatás nem érhető el, ServerBusy, "A bejövő forgalom meghaladja a fiók korlátját". 503 A szolgáltatás nem érhető el, ServerBusy, "A másodpercenkénti műveletek túllépik a fiókkorlátot". 503 A 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
AclFailedEntryList
DataLakeStorageError
Error	A szolgáltatáshiba-válasz objektum.
PathLeaseAction	A 2020-08-04-es verziótól kezdve a hozzáfűzési és kiürítési műveletekben. A Hozzáfűzés támogatja a "acquire", az "auto-renew" és a "acquire-release" műveletet. Ha "megszerzi" a bérletet, az megszerzi a bérletet. Ha az "automatikus megújítás" megújul a bérletet. Ha a "acquire-release" megszerzi a műveletet, & végrehajtja a műveletet, & a művelet befejezése után felszabadítja a bérletet. A "Release" művelet csak a kiürítési műveletben támogatott. Ha "igaz", akkor a bérletet az x-ms-lease-id fejlécből származó bérletazonosító-adatok használatával adja ki a fájlban.
PathUpdateAction	A műveletnek hozzá kell fűznie a fájlhoz hozzáfűzendő adatok feltöltéséhez, a "flush" művelettel kiürítheti a korábban feltöltött adatokat egy fájlba, a "setProperties" parancsot a fájl vagy könyvtár tulajdonságainak beállításához, a "setAccessControl" pedig a fájl vagy könyvtár tulajdonosának, csoportjának, engedélyeinek vagy hozzáférés-vezérlési listájának beállításához, a "setAccessControlRecursive" pedig a címtárak hozzáférés-vezérlési listájának rekurzív beállításához. Vegye figyelembe, hogy a hozzáférés-vezérlés használatához engedélyezni kell a hierarchikus névteret a fiókhoz. Azt is vegye figyelembe, hogy a Access Control lista (ACL) tartalmazza a tulajdonos, a tulajdonoscsoport és mások engedélyeit, így az x-ms-permissions és az x-ms-acl kérelemfejlécek kölcsönösen kizárják egymást.
SetAccessControlRecursiveResponse

AclFailedEntryList

Name	Típus	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Name	Típus	Description
error	Error	A szolgáltatáshiba-válasz objektum.

Error

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

Name	Típus	Description
code	string	A szolgáltatás hibakódja.
message	string	A szolgáltatás hibaüzenete.

PathLeaseAction

A 2020-08-04-es verziótól kezdve a hozzáfűzési és kiürítési műveletekben. A Hozzáfűzés támogatja a "acquire", az "auto-renew" és a "acquire-release" műveletet. Ha "megszerzi" a bérletet, az megszerzi a bérletet. Ha az "automatikus megújítás" megújul a bérletet. Ha a "acquire-release" megszerzi a műveletet, & végrehajtja a műveletet, & a művelet befejezése után felszabadítja a bérletet. A "Release" művelet csak a kiürítési műveletben támogatott. Ha "igaz", akkor a bérletet az x-ms-lease-id fejlécből származó bérletazonosító-adatok használatával adja ki a fájlban.

Name	Típus	Description
acquire	string
acquire-release	string
auto-renew	string
release	string

PathUpdateAction

A műveletnek hozzá kell fűznie a fájlhoz hozzáfűzendő adatok feltöltéséhez, a "flush" művelettel kiürítheti a korábban feltöltött adatokat egy fájlba, a "setProperties" parancsot a fájl vagy könyvtár tulajdonságainak beállításához, a "setAccessControl" pedig a fájl vagy könyvtár tulajdonosának, csoportjának, engedélyeinek vagy hozzáférés-vezérlési listájának beállításához, a "setAccessControlRecursive" pedig a címtárak hozzáférés-vezérlési listájának rekurzív beállításához. Vegye figyelembe, hogy a hozzáférés-vezérlés használatához engedélyezni kell a hierarchikus névteret a fiókhoz. Azt is vegye figyelembe, hogy a Access Control lista (ACL) tartalmazza a tulajdonos, a tulajdonoscsoport és mások engedélyeit, így az x-ms-permissions és az x-ms-acl kérelemfejlécek kölcsönösen kizárják egymást.

Name	Típus	Description
append	string
flush	string
setAccessControl	string
setAccessControlRecursive	string
setProperties	string

SetAccessControlRecursiveResponse

Name	Típus	Description
directoriesSuccessful	integer
failedEntries	AclFailedEntryList[]
failureCount	integer
filesSuccessful	integer