Path - Get Properties

Referencia

Service:: Storage Services

API Version:: 2023-08-03

Tulajdonságok lekérése | Állapot lekérése | Access Control lista lekérése | Hozzáférés ellenőrzése
A Tulajdonságok lekérése az elérési út összes rendszer- és felhasználó által definiált tulajdonságát visszaadja. Az Állapot lekérése az elérési út összes rendszer által definiált tulajdonságát visszaadja. A Get Access Control List függvény egy elérési út hozzáférés-vezérlési listáját adja vissza. 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.

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}

With optional parameters:

HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&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		PathGetPropertiesAction	Választható. Ha az érték "getStatus", a rendszer csak az elérési út rendszer által definiált tulajdonságait adja vissza. Ha az érték "getAccessControl", a rendszer visszaadja a hozzáférés-vezérlési listát a válaszfejlécekben (a hierarchikus névteret engedélyezni kell a fiókhoz), ellenkező esetben a rendszer visszaadja a tulajdonságokat.
fsAction	query		string	Csak a hozzáférési művelet ellenőrzéséhez szükséges. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. Fájlrendszerművelet olvasási/írási/végrehajtási sztring formában, egyező regex-minta :[rwx-]{3}"
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.
upn	query		boolean	Választható. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. Ha "igaz", az x-ms-owner, az x-ms-group és az x-ms-acl válaszfejlécekben visszaadott felhasználói identitásértékek az Azure Active Directory-objektumazonosítókról egyszerű felhasználónevekké alakulnak át. Ha "hamis", az értékek Azure Active Directory-objektumazonosítóként lesznek visszaadva. Az alapértelmezett érték a hamis. Vegye figyelembe, hogy a csoport- és alkalmazásobjektum-azonosítók nincsenek lefordítva, mert nem rendelkeznek egyedi felhasználóbarát névvel.

Kérelem fejléce

Name	Típus	Description
x-ms-lease-id	string	Választható. Ha ez a fejléc van megadva, a művelet csak akkor lesz végrehajtva, ha a következő feltételek teljesülnek: i) az elérési út bérlete jelenleg aktív, ii) a kérelemben megadott bérletazonosító megegyezik az elérési útéval. Regex pattern: `^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$`
If-Match	string	Választható. 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	Választható. 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	Választható. 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	Választható. 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-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.

Válaszok

Name	Típus	Description
200 OK		A fájl vagy könyvtár összes tulajdonságát visszaadja. Headers 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 Date: string ETag: string Last-Modified: string x-ms-request-id: string x-ms-version: string x-ms-resource-type: string x-ms-properties: string x-ms-owner: string x-ms-group: string x-ms-permissions: string x-ms-acl: string x-ms-lease-duration: string x-ms-lease-state: string x-ms-lease-status: string x-ms-server-encrypted: true/false: boolean x-ms-encryption-key-sha256: string x-ms-encryption-context: string x-ms-encryption-scope: string x-ms-creation-time: string x-ms-expiry-time: string
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 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

Name

Típus

Description

200 OK

A fájl vagy könyvtár összes tulajdonságát visszaadja.

Headers

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
Date: string
ETag: string
Last-Modified: string
x-ms-request-id: string
x-ms-version: string
x-ms-resource-type: string
x-ms-properties: string
x-ms-owner: string
x-ms-group: string
x-ms-permissions: string
x-ms-acl: string
x-ms-lease-duration: string
x-ms-lease-state: string
x-ms-lease-status: string
x-ms-server-encrypted: true/false: boolean
x-ms-encryption-key-sha256: string
x-ms-encryption-context: string
x-ms-encryption-scope: string
x-ms-creation-time: string
x-ms-expiry-time: string

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 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 objektum.
PathGetPropertiesAction	Választható. Ha az érték "getStatus", a rendszer csak az elérési út rendszer által definiált tulajdonságait adja vissza. Ha az érték "getAccessControl", a rendszer visszaadja a hozzáférés-vezérlési listát a válaszfejlécekben (a fiókhoz engedélyezni kell a hierarchikus névteret), ellenkező esetben a rendszer visszaadja a tulajdonságokat.

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.