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


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
accountName
path True

string

Az Azure Storage-fiók neve.

dnsSuffix
path True

string

Az Azure Data Lake Storage-végpont DNS-utótagja.

filesystem
path True

string

minLength: 3
maxLength: 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

  • 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-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
Other Status Codes

file

Részleges tartalom

Media Types: "application/json", "application/octet-stream", "text/plain"

Fejlécek

  • 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-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-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
Other Status Codes

DataLakeStorageError

Hiba történt. A lehetséges HTTP-állapotok, kód- és üzenetsztringek az alábbiak:

  • 400 Bad Request, ContentLengthMustBeZero, "A Content-Length kérelem fejlécének nullának kell lennie."
  • 400 Bad Request, InvalidAuthenticationInfo, "A hitelesítési információk nem a megfelelő formátumban jelennek meg. Ellenőrizze az Engedélyezési fejléc értékét."
  • 400 Bad Request, InvalidFlushPosition, "A feltöltött adatok nem egyeznek, 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átumban van."
  • 400 Bad Request, InvalidHttpVerb, "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 Hibás kérelem, InvalidPropertyName, "A tulajdonságnév nem lehet üres."
  • 400 Hibás kérelem, InvalidPropertyName, "A tulajdonságnév érvénytelen karaktereket tartalmaz."
  • 400 Bad Request, InvalidQueryParameterValue, "A kérelem URI-jában megadott egyik lekérdezési paraméter é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érelemhez 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 lekérdezési paraméterek egyike 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 lekérdezési paraméterek egyike nem támogatott."
  • 400 Bad Request, UnsupportedRestVersion, "A megadott rest verzió nem támogatott."
  • 403 Forbidden, AccountIsDisabled, "A megadott fiók le van tiltva."
  • 403 Forbidden, AuthorizationFailure, "Ez a kérés nem jogosult a művelet végrehajtására."
  • 403 Forbidden, InsufficientAccountPermissions, "A hozzáférés alatt álló fiók nem rendelkezik megfelelő engedélyekkel a művelet végrehajtásához."
  • 404 Not Found, 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 elérési út 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 Metódus nem engedélyezett, nem támogatottHttpVerb: "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 sem lehet a forráskönyvtár alkönyvtára."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "A forrás- és célerőforrás-típusnak azonosnak kell lennie."
  • 409 Conflict, LeaseAlreadyPresent, "Már létezik bérlet."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation: "A megadott bérletazonosító nem egyezett 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érlet azonosítója megfelelt, de a bérlet jelenleg feltört á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 feltört állapotban van, és nem módosítható."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed: "A bérlet azonosítója megfelelt, de a bérlet explicit módon megszakadt, és nem újítható meg."
  • 409 Conflict, LeaseNameMismatch, "A megadott bérletnév nem egyezett a meglévő bérlet nevével."
  • 409 Conflict, LeaseNotPresentWithLeaseOperation: "A bérletazonosító nincs jelen a megadott bérletműveletben."
  • 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örlésre van jelö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őkondicionálás 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 felelt meg az erőforrás bérletazonosítójának."
  • 412 Az előkondicionálás meghiúsult, LeaseIdMissing, "Jelenleg bérlet van az erőforráson, és a kérelemben nincs megadva bérletazonosító."
  • 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őkondicionálás 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érelem törzse 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 Internal Server Error, OperationTimedOut, "A művelet nem hajtható végre a megengedett időn belül."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A kimenő forgalom túllépte a fiókkorlátot."
  • 503 Szolgáltatás nem érhető el, ServerBusy: "A bejövő forgalom meghaladja a fiók korlátját."
  • 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."

Media Types: "application/json", "application/octet-stream", "text/plain"

Fejlécek

  • x-ms-request-id: string
  • x-ms-version: string

Definíciók

Name Description
DataLakeStorageError
Error

A szolgáltatáshiba-válasz objektum.

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.