Path - Update

Szolgáltatás:

Storage Services

API-verzió:

2023-08-03

Adatok hozzáfűzése | Adatok kiürítése | Tulajdonságok beállítása | Hozzáférés-vezérlés 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 egyidejű írások nem támogatottak ugyanahhoz a fájlhoz több ügyfél használatával. Ez a művelet támogatja a feltételes HTTP-kéréseket. További információ: Feltételes fejlécek megadása a Blob Service Operations.

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

Opcionális paraméterekkel:

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	Az Azure Data Lake Storage-végpont DNS-utótagja.
filesystem	path	True	string minLength: 3 maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$	A fájlrendszer azonosítója.
path	path	True	string	A fájl vagy könyvtár elérési útja.
action	query	True	PathUpdateAction	A műveletnek hozzáfűznie kell a fájlhoz hozzáfűzendő adatokat, a "flush" parancsot a korábban feltöltött adatok fájlba való kiürítéséhez, 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 hozzáférés-vezérlési lista (ACL) a tulajdonos, a tulajdonoscsoport és mások engedélyeit tartalmazza, így az x-ms-permissions és az x-ms-acl kérésfejlé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 jelzi, hogy ez-e az utolsó változás, amely megkülönbözteti a köztes öblítés és a fájlstream végső bezárásának különbségét. 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ődik, a szolgáltatás fájlmódosítási értesítést küld egy tulajdonsággal, amely 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 azt 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 útvonalak száma korlátozott. Ha a feldolgozandó útvonalak száma meghaladja ezt a korlátot, a rendszer egy folytatási jogkivonatot ad vissza az x-ms-folytatás válaszfejlécben. Ha egy folytatási jogkivonatot ad vissza a válaszban, százalékban kódoltnak kell lennie, és meg kell adni 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ítse a hozzáfűzési hívás során. Az alapértelmezett érték "false" (hamis), ha "true" (igaz) érték, 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 "hamis" művelet, a felhasználói hibák (4XX) észlelésekor gyorsan leáll. Ha "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 állapota mindkét forgatókönyv válaszában jelenik meg. 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) minimum: 1	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 fogja. Ha 2000-nél nagyobb vagy nem nagyobb, a kérelem legfeljebb 2000 elemet fog feldolgozni
mode	query		string	Opcionális. É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 POSIX-hozzáférés-vezérlési jogosultságot, amelyek korábban a fájlokon és könyvtárakon voltak 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 helyet kell megadnia, ahol az adatokat hozzá kell fűzni. A feltöltött adatok nem lesznek azonnal kipirulva 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 egyeztetni 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 nem véglegesített adatok megmaradnak a kiürítési művelet befejezése után; ellenkező esetben a rendszer a kiürítési művelet után törli a nem véglegesített adatokat. Az alapértelmezett érték hamis. Ha a kiürítés sikeres, a megadott pozíciónál kisebb eltolású adatok lesznek a fájlba írva, de ez az opcionális paraméter lehetővé teszi, hogy a kiürítési pozíciót követő adatok megmaradjanak egy későbbi kiürítési művelethez.
timeout	query		integer (int32) minimum: 1	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) minimum: 0	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	Opcionális. A kérelem tartalmának MD5 kivonata. Ez a fejléc érvényes a "Hozzáfűzés" és a "Flush" műveletekre. Ez a kivonat a kérelem tartalmának sértetlenségének ellenőrzésére szolgál az átvitel során. Ha ez az élőfej 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 a 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ának a fájlnak a tárolt tartalmához.
x-ms-lease-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Aktív bérlet esetén meg kell adni a bérlet azonosítóját. A "setAccessControlRecursive" műveletek esetében érvénytelen.
x-ms-cache-control		string	Nem kötelező és csak a tulajdonságok kiürítési és beállítási műveleteire érvényes. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Cache-Control" válaszfejlécében tárolja.
x-ms-content-type		string	Nem kötelező és csak a tulajdonságok kiürítési és beállítási műveleteire érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza a "Fájl olvasása" műveletek "Content-Type" válaszfejlécében.
x-ms-content-disposition		string	Nem kötelező és csak a tulajdonságok kiürítési és beállítási műveleteire érvényes. A szolgáltatás tárolja ezt az értéket, és belefoglalja a "Fájl olvasása" műveletek "Content-Disposition" válaszfejlécére.
x-ms-content-encoding		string	Nem kötelező és csak a tulajdonságok kiürítési és beállítási műveleteire érvényes. A szolgáltatás tárolja ezt az értéket, és a "Fájl olvasása" műveletek "Content-Encoding" válaszfejlécében tárolja.
x-ms-content-language		string	Nem kötelező és csak a tulajdonságok kiürítési és beállítási műveleteire érvényes. A szolgáltatás tárolja ezt az értéket, és tartalmazza a "Fájl olvasása" műveletek "Content-Language" válaszfejlécében.
x-ms-content-md5		string	Nem kötelező, és csak a "Flush and Set Properties" műveletekre érvényes. A szolgáltatás tárolja ezt az értéket, és a "Content-Md5" válaszfejlécbe foglalja az "Olvasás és tulajdonságok lekérése" műveletekhez. 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" későbbi hívásai csak akkor adják vissza ezt a tulajdonságot, ha az újra explicit módon be van állítva a fájlon.
x-ms-properties		string	Opcionális. A fájllal vagy könyvtárral 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. Ha a fejléc nincs megadva, az összes tulajdonság el lesz távolítva. Új és meglévő tulajdonságok egyesítése érdekében először szerezze be az összes meglévő tulajdonságot és az aktuális E-Címkét, majd küldjön feltételes kérelmet az E-Címkével, és foglalja bele az összes tulajdonság értékeit.
x-ms-owner		string	Nem kötelező és csak a setAccessControl műveletre é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űveletre é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 hierarchikus névtér engedélyezve van a fiókhoz. POSIX-hozzáférési engedélyeket állít be a fájltulajdonos, a fájltulajdonosi csoport és mások számára. 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 ragacsos bit is támogatott, és szimbolikus jelölésben t vagy T betű jelöli az utolsó karakterhelyen attól függően, hogy a többi kategória végrehajtási bitje be van-e állítva, vagy nincs-e megadva (például rwxrw-rw- ragacsos bittel rwxrw-rwT. A ragadós bittel rendelkező rwx rwx rwx rwx-rwt, a t vagy a T hiánya azt jelzi, hogy a ragadós bit nincs beállítva. A négyjegyű oktális jelölésben az 1. számjegy (például 1766 az rwxrw-rw- ragacsos bitet, a 0766 pedig az rwxrw-rw-t jelöli ragadós bit 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. A POSIX hozzáférés-vezérlési jogosultságainak beállítása fájlokon és könyvtárakon. Az érték a hozzáférés-vezérlési bejegyzések vesszővel tagolt listája, amely teljes mértékben felülírja 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 "módosítás" 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, típusból, felhasználó- vagy csoportazonosítóból és "[hatókör:][típus]:[id]:[engedélyek]" formátumú engedélyekből áll. A hatókörnek "alapértelmezettnek" kell lennie, hogy jelezze, hogy az ACE a címtá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 elnevezett felhasználónak, a "csoport" a tulajdonoscsoportnak vagy egy elnevezett csoportnak, 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 tulajdonoscsoport 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 van. A következő ACL például olvasási, írási és végrehajtási jogokat biztosít a fájltulajdonosnak és a john.doe@contoso, a tulajdonoscsoport olvasási jogának, és semmi másnak: "user::rwx,user:john.doe@contoso:rwx,group::r--,other::---,mask=rwx". Az x-ms-engedélyekkel 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 "user:john.doe@contoso:, mask:" (felhasználó:john.doe@contoso:, maszk:) megadott hozzáférés-vezérlési listában. A setAccessControlRecursive "set" üzemmódja beállítja a megadott hatókör meglévő ACL-jeit lecserélő ACL-eket, és tartalmaznia kell mind a háromat – a tulajdonos felhasználót, a tulajdonoscsoportot és az 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 hozzáférés-vezérlés és a tulajdonságok beállítása, de érvénytelen az adatok hozzáfűzése és a hozzáférés-vezérlés rekurzív beállítása esetén. 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őjelekben kell megadni.
If-None-Match		string	Nem kötelező az adatok kiürítése, a hozzáférés-vezérlés és a tulajdonságok beállítása, de érvénytelen az adatok hozzáfűzése és a hozzáférés-vezérlés rekurzív beállítása esetén. ETag-érték vagy speciális helyettesítő ("*") érték. Adja meg ezt a fejlécet, hogy csak akkor hajtsa végre a műveletet, ha az erőforrás ETagje nem felel meg a megadott értéknek. Az ETaget idézőjelekben kell megadni.
If-Modified-Since		string	Az adatok kiürítése és a tulajdonságok megadása nem kötelező, de érvénytelen az Adatok hozzáfűzése és a Hozzáférés-vezérlés rekurzív beállítása esetén. Dátum- és időérték. Adja meg ezt a fejlécet 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	Az adatok kiürítése és a tulajdonságok megadása nem kötelező, de érvénytelen az Adatok hozzáfűzése és a Hozzáférés-vezérlés rekurzív beállítása esetén. Dátum- és időérték. Adja meg ezt a fejlécet 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	Opcionális. A Base64 kódolású AES-256 titkosítási kulcs.
x-ms-encryption-key-sha256		string	Opcionális. A titkosítási kulcs Base64 kódolású SHA256 kivonata.
x-ms-encryption-algorithm: AES256		string	Opcionális. Megadja a titkosításhoz használni kívánt 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 öblítési műveletekben. A Append támogatja a "beolvasás", az "automatikus megújítás" é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, az megújítja a bérletet. Ha a "felszerzés-kiadás" a művelet végrehajtása után & befejezi a műveletet, & a bérlet kiadását. A "Kiadás" művelet csak a kiürítési műveletben támogatott. Ha "igaz", az x-ms-lease-id fejlécből származó bérletazonosító adataival felszabadítja a bérletet a fájlon.
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 között kell lennie, vagy végtelen bérlet esetén -1.
x-ms-proposed-lease-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Akkor szükséges, ha az "x-ms-lease-action" "acquire" vagy "change". Ha a művelet sikeres, a rendszer ezzel a bérletazonosítóval szerez be egy bérletet.
x-ms-client-request-id		string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	Az elemzési naplókban rögzített UUID a hibaelhárításhoz és a korrelációhoz.
x-ms-date		string	A kérelem koordinált egyetemes idejét (UTC) adja meg. Ez a megosztott kulcsok engedélyezéséhez szükséges.
x-ms-version		string	A kérelem feldolgozásához használt REST protokoll verzióját adja meg. Ez a megosztott kulcsok engedélyezéséhez szükséges.

Kérelem törzse

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

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

Válaszok

Name	Típus	Description
200 OK	SetAccessControlRecursiveResponse	Az adatok ki lettek ürítve (megírva) a fájlba, vagy a tulajdonságok sikeresen be lettek állítva. A válasz törzse nem kötelező, és csak a "SetAccessControlRecursive" esetén érvényes Fejlécek 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 elfogadása megtörtént. Fejlécek 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á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 jelennek meg. Ellenőrizze az Engedélyezési fejléc értékét." 400 Bad Request, InvalidFlushPosition, "A feltöltött adatok nem egyeznek, 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átumban van." 400 Bad Request, InvalidHttpVerb, "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 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 Bad Request, 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 lekérdezési paraméterek egyike 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 lekérdezési paraméterek egyike nem támogatott." 400 Bad Request, UnsupportedRestVersion, "A megadott rest verzió nem támogatott." 403 Forbidden, AccountIsDisabled, "A megadott fiók le van tiltva." 403 Forbidden, AuthorizationFailure, "Ez a kérés nem jogosult a művelet végrehajtására." 403 Forbidden, InsufficientAccountPermissions, "A hozzáférés alatt álló fiók nem rendelkezik megfelelő engedélyekkel a művelet végrehajtásához." 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 Metódus nem engedélyezett, nem támogatottHttpVerb: "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 sem 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 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érlet azonosítója megfelelt, de a bérlet jelenleg feltört á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 feltört állapotban van, és nem módosítható." 409 Conflict, LeaseIsBrokenAndCannotBeRenewed: "A bérlet azonosítója megfelelt, de a bérlet explicit módon megszakadt, és nem újítható meg." 409 Conflict, LeaseNameMismatch, "A megadott bérletnév nem egyezett a meglévő bérlet nevével." 409 Conflict, LeaseNotPresentWithLeaseOperation: "A bérletazonosító nincs jelen a megadott bérletműveletben." 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örlésre van jelö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őkondicionálás 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 felelt meg az erőforrás bérletazonosítójának." 412 Az előkondicionálás meghiúsult, LeaseIdMissing, "Jelenleg bérlet van az erőforráson, és a kérelemben nincs megadva bérletazonosító." 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őkondicionálás 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érelem törzse 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 Internal Server Error, 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 Szolgáltatás nem érhető el, ServerBusy: "A bejövő forgalom meghaladja a fiók korlátját." 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." Fejlécek 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 öblítési műveletekben. A Append támogatja a "beolvasás", az "automatikus megújítás" é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, az megújítja a bérletet. Ha a "felszerzés-kiadás" a művelet végrehajtása után & befejezi a műveletet, & a bérlet kiadását. A "Kiadás" művelet csak a kiürítési műveletben támogatott. Ha "igaz", az x-ms-lease-id fejlécből származó bérletazonosító adataival felszabadítja a bérletet a fájlon.
PathUpdateAction	A műveletnek hozzáfűznie kell a fájlhoz hozzáfűzendő adatokat, a "flush" parancsot a korábban feltöltött adatok fájlba való kiürítéséhez, 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 hozzáférés-vezérlési lista (ACL) a tulajdonos, a tulajdonoscsoport és mások engedélyeit tartalmazza, így az x-ms-permissions és az x-ms-acl kérésfejlécek kölcsönösen kizárják egymást.
SetAccessControlRecursiveResponse

AclFailedEntryList

Objektum

Name	Típus	Description
errorMessage	string
name	string
type	string

DataLakeStorageError

Objektum

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

Error

Objektum

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

Enumerálás

A 2020-08-04-es verziótól kezdve a hozzáfűzési és öblítési műveletekben. A Append támogatja a "beolvasás", az "automatikus megújítás" é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, az megújítja a bérletet. Ha a "felszerzés-kiadás" a művelet végrehajtása után & befejezi a műveletet, & a bérlet kiadását. A "Kiadás" művelet csak a kiürítési műveletben támogatott. Ha "igaz", az x-ms-lease-id fejlécből származó bérletazonosító adataival felszabadítja a bérletet a fájlon.

Érték	Description
acquire
acquire-release
auto-renew
release

PathUpdateAction

Enumerálás

A műveletnek hozzáfűznie kell a fájlhoz hozzáfűzendő adatokat, a "flush" parancsot a korábban feltöltött adatok fájlba való kiürítéséhez, 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 hozzáférés-vezérlési lista (ACL) a tulajdonos, a tulajdonoscsoport és mások engedélyeit tartalmazza, így az x-ms-permissions és az x-ms-acl kérésfejlécek kölcsönösen kizárják egymást.

Érték	Description
append
flush
setAccessControl
setAccessControlRecursive
setProperties

SetAccessControlRecursiveResponse

Objektum

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