Path - Read
Fájl olvasása
Olvassa el a fájl tartalmát. Olvasási műveletek esetén a tartománykérések támogatottak. 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.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?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. |
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
Name | Kötelező | Típus | Description |
---|---|---|---|
Range |
string |
A HTTP-tartomány kérelemfejléce a lekérendő erőforrás egy vagy több bájttartományát adja meg. |
|
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. |
|
x-ms-range-get-content-md5 |
boolean |
Opcionális. Ha ez az élőfej "true" (igaz) értékre van állítva, és a Tartomány fejlécével együtt van megadva, a szolgáltatás visszaadja a tartomány MD5 kivonatát, amennyiben a tartomány kisebb vagy egyenlő 4 MB-nál. Ha ez az élőfej a Tartomány fejléc nélkül van megadva, a szolgáltatás a 400-ás állapotkódot adja vissza (hibás kérés). Ha ez a fejléc igaz értékre van állítva, ha a tartomány mérete meghaladja a 4 MB-ot, a szolgáltatás a 400-es állapotkódot adja vissza (hibás kérés). |
|
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 |
file |
Oké Media Types: "application/json", "application/octet-stream", "text/plain" Fejlécek
|
Other Status Codes |
file |
Részleges tartalom Media Types: "application/json", "application/octet-stream", "text/plain" Fejlécek
|
Other Status Codes |
Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:
Media Types: "application/json", "application/octet-stream", "text/plain" Fejlécek
|
Definíciók
Name | Description |
---|---|
Data |
|
Error |
A szolgáltatáshiba-válasz objektum. |
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. |