Path - Get Properties
Tulajdonságok lekérése | Állapot lekérése | Hozzáférés-vezérlési 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 adja vissza. Az Állapot lekérése az elérési út rendszer által definiált összes tulajdonságát adja vissza. A Hozzáférés-vezérlési lista lekérése az 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 a Blob Service Operations.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
account
|
path | True |
string |
Az Azure Storage-fiók neve. |
dns
|
path | True |
string |
Az Azure Data Lake Storage-végpont DNS-utótagja. |
filesystem
|
path | True |
string minLength: 3maxLength: 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 |
Opcionális. Ha az érték "getStatus", akkor a rendszer csak az elérési út rendszer által definiált tulajdonságait adja vissza. Ha az érték "getAccessControl", akkor a rendszer a válaszfejlécekben adja vissza a hozzáférés-vezérlési listát (a fiókhoz engedélyezni kell a hierarchikus névteret), ellenkező esetben a rendszer visszaadja a tulajdonságokat. |
||
fs
|
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ása/írása/végrehajtása sztring formában, egyező regex minta :[rwx-]{3}' |
|
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. |
|
upn
|
query |
boolean |
Opcionális. 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 azure Active Directory-objektumazonosítókból egyszerű felhasználónevekké alakulnak. Ha "hamis", a rendszer az értékeket Azure Active Directory-objektumazonosítókként adja vissza. Az alapértelmezett érték 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 | Kötelező | Típus | Description |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Opcionális. Ha ez a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha az alábbi 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. |
|
If-Match |
string |
Opcionális. 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 |
Opcionális. 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 |
Opcionális. 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 |
Opcionális. 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-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. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A fájl vagy könyvtár összes tulajdonságát adja vissza. Fejlécek
|
|
Other Status Codes |
Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:
Fejlécek
|
Definíciók
Name | Description |
---|---|
Data |
|
Error |
A szolgáltatáshiba-válasz objektum. |
Path |
Opcionális. Ha az érték "getStatus", akkor a rendszer csak az elérési út rendszer által definiált tulajdonságait adja vissza. Ha az érték "getAccessControl", akkor a rendszer a válaszfejlécekben adja vissza a hozzáférés-vezérlési listát (a fiókhoz engedélyezni kell a hierarchikus névteret), ellenkező esetben a rendszer visszaadja a tulajdonságokat. |
DataLakeStorageError
Name | Típus | Description |
---|---|---|
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. |
PathGetPropertiesAction
Opcionális. Ha az érték "getStatus", akkor a rendszer csak az elérési út rendszer által definiált tulajdonságait adja vissza. Ha az érték "getAccessControl", akkor a rendszer a válaszfejlécekben adja vissza a hozzáférés-vezérlési listát (a fiókhoz engedélyezni kell a hierarchikus névteret), ellenkező esetben a rendszer visszaadja a tulajdonságokat.
Érték | Description |
---|---|
checkAccess | |
getAccessControl | |
getStatus |