Megosztás a következőn keresztül:


Path - Update

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}
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.

Reguláris kifejezési minta: ^[$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.

Reguláris kifejezési minta: ^[{(]?[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.

Reguláris kifejezési minta: ^[{(]?[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.

Reguláris kifejezési minta: ^[{(]?[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

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 el lett fogadva.

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á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."

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 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