Sdílet prostřednictvím

Path - Read

  • Reference
Služba:
Storage Services
Verze rozhraní API:
2023-08-03

Přečíst soubor
Přečtěte si obsah souboru. Pro operace čtení se podporují žádosti o rozsah. Tato operace podporuje podmíněné požadavky HTTP. Další informace najdete v tématu Určení podmíněných hlaviček pro operace služby Blob Service.

GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
S volitelnými parametry: 
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
 path True

string

Název účtu služby Azure Storage.
dnsSuffix
 path True

string

Přípona DNS pro koncový bod Azure Data Lake Storage.
filesystem
 path True

string

Identifikátor systému souborů.

Vzor regulárního výrazu: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

Cesta k souboru nebo adresáři.
timeout
 query

integer

int32

Volitelná hodnota časového limitu operace v sekundách. Období začíná tím, že služba obdrží požadavek. Pokud hodnota časového limitu uplynou před dokončením operace, operace selže.

Hlavička požadavku

Name Vyžadováno Typ Description
Range

string

Hlavička požadavku Rozsah HTTP určuje jeden nebo více bajtů rozsahů prostředku, který se má načíst.
x-ms-lease-id

string

Nepovinný parametr. Pokud je zadána tato hlavička, operace se provede pouze v případě, že jsou splněny obě následující podmínky: i) zapůjčení cesty je aktuálně aktivní a ii) ID zapůjčení zadané v požadavku odpovídá ID cesty.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-range-get-content-md5

boolean

Nepovinný parametr. Pokud je tato hlavička nastavená na hodnotu true a je zadána společně s hlavičkou Range, vrátí služba hodnotu hash MD5 pro rozsah, pokud je rozsah menší než nebo roven 4 MB. Pokud je tato hlavička zadána bez hlavičky Range, vrátí služba stavový kód 400 (Chybný požadavek). Pokud je tato hlavička nastavená na hodnotu true, když rozsah přesahuje velikost 4 MB, vrátí služba stavový kód 400 (Chybný požadavek).
If-Match

string

Nepovinný parametr. Hodnota ETag. Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku odpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách.
If-None-Match

string

Nepovinný parametr. Hodnota ETag nebo speciální hodnota se zástupným znakem (*). Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že značka ETag prostředku neodpovídá zadané hodnotě. Značka ETag musí být zadána v uvozovkách.
If-Modified-Since

string

Nepovinný parametr. Hodnota data a času Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že se prostředek od zadaného data a času změnil.
If-Unmodified-Since

string

Nepovinný parametr. Hodnota data a času Tuto hlavičku zadejte, pokud chcete operaci provést pouze v případě, že prostředek nebyl od zadaného data a času změněn.
x-ms-encryption-key

string

Nepovinný parametr. Šifrovací klíč AES-256 s kódováním Base64.
x-ms-encryption-key-sha256

string

Nepovinný parametr. Hodnota hash SHA256 s kódováním Base64 šifrovacího klíče.
x-ms-encryption-algorithm: AES256

string

Nepovinný parametr. Určuje algoritmus, který se má použít k šifrování. Hodnota této hlavičky musí být AES256.
x-ms-client-request-id

string

Identifikátor UUID zaznamenaný v analytických protokolech pro řešení potíží a korelaci.

Vzor regulárního výrazu: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Určuje formát UTC (Coordinated Universal Time). To se vyžaduje při použití autorizace sdíleného klíče.
x-ms-version

string

Určuje verzi protokolu REST, která se použije ke zpracování požadavku. To se vyžaduje při použití autorizace sdíleného klíče.

Odpovědi

Name Typ Description
200 OK

file

Ok

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

Hlavičky

  • 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

Částečný obsah

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

Hlavičky

  • 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

Došlo k chybě. Možné řetězce stavu HTTP, kódu a zprávy jsou uvedené níže:

  • 400 Chybný požadavek, ContentLengthMustBeZero, "Hlavička požadavku Content-Length musí být nulová."
  • 400 Chybný požadavek, InvalidAuthenticationInfo, "Ověřovací informace nejsou zadány ve správném formátu. Zkontrolujte hodnotu hlavičky Authorization.
  • 400 Chybný požadavek, InvalidFlushPosition, "Nahraná data nejsou souvislá nebo hodnota parametru dotazu position se nerovná délce souboru po připojení nahraných dat."
  • 400 Chybný požadavek, InvalidHeaderValue, "Hodnota jedné z hlaviček HTTP není ve správném formátu."
  • 400 – Chybný požadavek, InvalidHttpVerb, "Zadaný příkaz HTTP je neplatný – server ho nerozpoznal."
  • 400 Chybný požadavek, InvalidInput, "Jeden ze vstupů požadavku není platný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti nemůže být prázdný."
  • 400 Chybný požadavek, InvalidPropertyName, "Název vlastnosti obsahuje neplatné znaky."
  • 400 – Chybný požadavek, InvalidQueryParameterValue, Hodnota jednoho z parametrů dotazu zadaných v identifikátoru URI požadavku je neplatná.
  • 400 – Chybný požadavek, InvalidResourceName, "Zadaný název prostředku obsahuje neplatné znaky."
  • 400 – Chybný požadavek, InvalidSourceUri, identifikátor URI zdroje je neplatný.
  • 400 – Chybný požadavek, InvalidUri, Identifikátor URI požadavku je neplatný.
  • 400 – Chybný požadavek, MissingRequiredHeader, "Není zadána hlavička HTTP, která je pro tento požadavek povinná."
  • 400 – Chybný požadavek, MissingRequiredQueryParameter, parametr dotazu, který je pro tento požadavek povinný, není zadaný.
  • 400 Chybný požadavek, MultipleConditionHeadersNotSupported, "Více hlaviček podmínek není podporováno."
  • 400 – Chybný požadavek, OutOfRangeInput, "Jeden ze vstupů požadavku je mimo rozsah."
  • 400 Chybný požadavek, OutOfRangeQueryParameterValue, "Jeden z parametrů dotazu zadaný v identifikátoru URI požadavku je mimo povolený rozsah."
  • 400 Chybný požadavek, UnsupportedHeader, "Jedna z hlaviček zadaných v požadavku není podporována."
  • 400 – Chybný požadavek, UnsupportedQueryParameter, "Jeden z parametrů dotazu zadaný v identifikátoru URI požadavku se nepodporuje."
  • 400 Chybný požadavek, UnsupportedRestVersion, "Zadaná verze REST není podporována."
  • 403 ForBidden, AccountIsDisabled, "Zadaný účet je zakázaný."
  • 403 ForBidden, AuthorizationFailure, "Tento požadavek nemá oprávnění k provedení této operace."
  • 403 ForBidden, InsufficientAccountPermissions, "Účet, ke kterým přistupujete, nemá dostatečná oprávnění k provedení této operace."
  • 404 Nenalezeno, FilesystemNotFound, "Zadaný systém souborů neexistuje."
  • 404 Nenalezeno, PathNotFound, "Zadaná cesta neexistuje."
  • 404 Nenalezeno, RenameDestinationParentPathNotFound, Nadřazený adresář cílové cesty neexistuje.
  • 404 Nenalezeno, ResourceNotFound, Zadaný prostředek neexistuje.
  • 404 Nenalezeno, SourcePathNotFound, Zdrojová cesta pro operaci přejmenování neexistuje.
  • Metoda 405 není povolená, unsupportedHttpVerb, "Prostředek nepodporuje zadaný příkaz HTTP."
  • 409 Conflict, DestinationPathIsBeingDeleted, "Zadaná cílová cesta je označena k odstranění."
  • 409 Conflict, DirectoryNotEmpty, "Hodnota parametru rekurzivního dotazu musí být true, aby bylo možné odstranit neprázdný adresář."
  • 409 Conflict, FilesystemAlreadyExists, "Zadaný systém souborů již existuje."
  • 409 Conflict, FilesystemBeingDeleted, "Zadaný systém souborů je odstraněn."
  • 409 Conflict, InvalidDestinationPath, "Zadaná cesta nebo prvek cesty existuje a typ prostředku je pro tuto operaci neplatný." * 409 – Konflikt, InvalidFlushOperation, Prostředek byl vytvořen nebo upraven rozhraním API služby Blob Service a rozhraní API služby Data Lake Storage do ho nemůže zapisovat.
  • 409 Conflict, InvalidRenameSourcePath, "Zdrojový adresář nemůže být stejný jako cílový adresář, ani cíl nemůže být podadresář zdrojového adresáře."
  • 409 Conflict, InvalidSourceOrDestinationResourceType, "Typ zdrojového a cílového prostředku musí být identický."
  • 409 Conflict, LeaseAlreadyPresent, "Již existuje zapůjčení."
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "Zadané ID zapůjčení neodpovídá ID zapůjčení pro prostředek se zadanou operací zapůjčení."
  • 409 Conflict, LeaseIsAlreadyBroken, "Zapůjčení již bylo přerušeno a nelze ho znovu přerušit."
  • 409 Conflict, LeaseIsBreakingAndCannotBeAcquired, "ID zapůjčení bylo spárováno, ale zapůjčení je aktuálně ve stavu přerušení a nelze jej získat, dokud není přerušeno."
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "ID zapůjčení se shoduje, ale zapůjčení je aktuálně ve stavu přerušení a nelze ho změnit."
  • 409 Conflict, LeaseIsBrokenAndCannotBeRenewed, "ID zapůjčení se shoduje, ale zapůjčení bylo explicitně poškozeno a nelze jej obnovit."
  • 409 Conflict, LeaseNameMismatch, "Zadaný název zapůjčení neodpovídá názvu existujícího zapůjčení."
  • 409 – Konflikt, LeaseNotPresentWithLeaseOperation, ID zapůjčení neexistuje u zadané operace zapůjčení.
  • 409 Conflict, PathAlreadyExists, "Zadaná cesta již existuje."
  • 409 Konflikt, PathConflict, "Zadaná cesta nebo prvek cesty existuje a její typ prostředku je pro tuto operaci neplatný."
  • 409 Conflict, SourcePathIsBeingDeleted, "Zadaná zdrojová cesta je označena k odstranění."
  • 409 Conflict, ResourceTypeMismatch, "Typ prostředku zadaný v požadavku neodpovídá typu prostředku."
  • 412 Předběžná podmínka selhala, PodmínkaNotMet: Podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna.
  • 412 Předběžná podmínka selhala, LeaseIdMismatch, Zadané ID zapůjčení neodpovídá ID zapůjčení prostředku.
  • 412 Předběžná podmínka se nezdařila, LeaseIdMissing: Prostředek aktuálně má zapůjčení a v žádosti nebylo zadáno žádné ID zapůjčení.
  • 412 Předběžná podmínka selhala, LeaseNotPresent, "Prostředek momentálně nemá žádné zapůjčení."
  • 412 Předběžná podmínka selhala, LeaseLost, "Bylo zadáno ID zapůjčení, ale vypršela platnost zapůjčení prostředku."
  • 412 Předběžná podmínka selhala, SourceConditionNotMet, "Zdrojová podmínka zadaná pomocí podmíněných hlaviček HTTP není splněna."
  • 413 Request Entity Too Large, RequestBodyTooLarge, "Text požadavku je příliš velký a překračuje maximální povolený limit."
  • 416 Požadovaný rozsah není uspokojitelný, InvalidRange, "Zadaný rozsah je neplatný pro aktuální velikost prostředku."
  • 500 Vnitřní chyba serveru, InternalError, "Server zjistil vnitřní chybu. Zkuste žádost zopakovat.
  • 500 Vnitřní chyba serveru, OperationTimedOut, "Operaci nelze dokončit v povoleném čase."
  • 503 Service Unavailable, ServerBusy, "Egress is over the account limit" (Výchozí přenos dat je nad limitem účtu).
  • 503 Služba není k dispozici, ServerBusy, "Příchozí přenos dat překročil limit účtu".
  • 503 Service Unavailable, ServerBusy, "Operations per second is over the account limit" (Počet operací za sekundu je nad limitem účtu).
  • 503 Služba není k dispozici, ServerBusy, "Server v současné době nemůže přijímat požadavky. Zkuste prosím žádost zopakovat."

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

Hlavičky

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

Definice

Name Description
DataLakeStorageError
Error

Objekt odpovědi na chybu služby.

DataLakeStorageError

Name Typ Description
error

Error

Objekt odpovědi na chybu služby.

Error

Objekt odpovědi na chybu služby.

Name Typ Description
code

string

Kód chyby služby.
message

string

Chybová zpráva služby.