Path - List
Az elérési utak és tulajdonságaik listázása az adott fájlrendszerben.
GET https://{accountName}.{dnsSuffix}/{filesystem}?recursive={recursive}&resource=filesystem
GET https://{accountName}.{dnsSuffix}/{filesystem}?directory={directory}&recursive={recursive}&continuation={continuation}&maxResults={maxResults}&upn={upn}&resource=filesystem&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. Az értéknek betűvel vagy számmal kell kezdődnie és végződnie, és csak betűket, számokat és kötőjelet (-) kell tartalmaznia. Egymást követő kötőjelek nem engedélyezettek. Minden betűnek kisbetűnek kell lennie. Az értéknek 3 és 63 karakter közöttinek kell lennie. |
recursive
|
query | True |
boolean |
Ha "igaz", az összes elérési út megjelenik; ellenkező esetben csak a fájlrendszer gyökerében lévő elérési utak jelennek meg. Ha a "könyvtár" meg van adva, a lista csak az azonos gyökerű elérési utakat tartalmazza. |
resource
|
query | True |
Az értéknek "fájlrendszernek" kell lennie az összes fájlrendszerművelethez. |
|
continuation
|
query |
string |
Az egyes hívásokkal visszaadott útvonalak száma korlátozott. Ha a visszaadandó ú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, azt a listaművelet egy későbbi meghívásában kell megadni az útvonalak listázásának folytatásához. Vegye figyelembe, hogy az x-ms-folytatás válaszfejlécben visszaadott folytatási jogkivonatnak URL-címet kell kódolnia, mielőtt egy későbbi meghívásban használna. |
|
directory
|
query |
string |
Szűri az eredményeket a megadott könyvtár elérési útjaira. Hiba történik, ha a könyvtár nem létezik. |
|
max
|
query |
integer (int32) minimum: 1 |
Nem kötelező érték, amely meghatározza a visszaadandó elemek maximális számát. Ha nincs megadva vagy 5000-nél nagyobb, a válasz legfeljebb 5000 elemet tartalmaz. |
|
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 egyes listabejegyzések tulajdonos- és csoportmezőiben 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-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 |
Oké 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. |
Filesystem |
Az értéknek "fájlrendszernek" kell lennie az összes fájlrendszerművelethez. |
Path | |
Path |
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. |
FilesystemResourceType
Az értéknek "fájlrendszernek" kell lennie az összes fájlrendszerművelethez.
Érték | Description |
---|---|
filesystem |
Path
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
contentLength |
integer (int64) |
||
etag |
string |
||
group |
string |
||
isDirectory |
boolean |
False | |
lastModified |
string |
||
name |
string |
||
owner |
string |
||
permissions |
string |
||
x-ms-encryption-context |
string |
Ha a titkosítási környezet tulajdonságértéke be van állítva, akkor a megadott értéket adja vissza. Csak akkor érvényes, ha a hierarchikus névtér engedélyezve van a fiókhoz. |
|
x-ms-encryption-key-sha256 |
string |
A kiszolgáló az ügyfél által megadott titkosítási kulcs SHA256-ját fogja visszajeleníteni a műveletben használt kulcs ellenőrzéséhez. |
|
x-ms-encryption-scope |
string |
Ha a kérelem titkosítási hatókört használt, így az ügyfél meggyőződhet arról, hogy a kérés tartalma sikeresen titkosítva van a titkosítási hatókör használatával. |
|
x-ms-server-encrypted: true/false |
boolean |
A fejléc értéke igaz értékre van állítva, ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. |
PathList
Name | Típus | Description |
---|---|---|
paths |
Path[] |