Path - Read
Leer archivo
Lea el contenido de un archivo. En el caso de las operaciones de lectura, se admiten las solicitudes de intervalo. Esta operación admite solicitudes HTTP condicionales. Para obtener más información, consulte Especificación de encabezados condicionales para las operaciones de Blob Service.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nombre de la cuenta de Azure Storage. |
dns
|
path | True |
string |
Sufijo DNS para el punto de conexión de Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identificador del sistema de archivos. Patrón de Regex: |
path
|
path | True |
string |
Ruta de acceso del archivo o directorio. |
timeout
|
query |
integer int32 |
Valor de tiempo de espera de operación opcional en segundos. El período comienza cuando el servicio recibe la solicitud. Si el valor de tiempo de espera transcurre antes de que se complete la operación, se produce un error en la operación. |
Encabezado de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
Range |
string |
El encabezado de solicitud de intervalo HTTP especifica uno o varios intervalos de bytes del recurso que se van a recuperar. |
|
x-ms-lease-id |
string |
Opcional. Si se especifica este encabezado, la operación solo se realizará si se cumplen las dos condiciones siguientes: i) la concesión de la ruta de acceso está activa actualmente y ii) el identificador de concesión especificado en la solicitud coincide con el de la ruta de acceso. Patrón de Regex: |
|
x-ms-range-get-content-md5 |
boolean |
Opcional. Cuando este encabezado se establece en "true" y se especifica junto con el encabezado Range, el servicio devuelve el hash MD5 para el intervalo, siempre que el intervalo sea menor o igual que 4 MB de tamaño. Si este encabezado se especifica sin el encabezado Range, el servicio devuelve el código de estado 400 (Solicitud incorrecta). Si este encabezado se establece en true cuando el intervalo supera los 4 MB de tamaño, el servicio devuelve el código de estado 400 (solicitud incorrecta). |
|
If-Match |
string |
Opcional. Valor ETag. Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado. La ETag debe especificarse entre comillas. |
|
If-None-Match |
string |
Opcional. Un valor ETag o el valor comodín especial ("*"). Especifique este encabezado para realizar la operación solo si la ETag del recurso no coincide con el valor especificado. La ETag debe especificarse entre comillas. |
|
If-Modified-Since |
string |
Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso se ha modificado desde la fecha y hora especificadas. |
|
If-Unmodified-Since |
string |
Opcional. Valor de fecha y hora. Especifique este encabezado para realizar la operación solo si el recurso no se ha modificado desde la fecha y hora especificadas. |
|
x-ms-encryption-key |
string |
Opcional. La clave de cifrado AES-256 codificada en Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opcional. Hash SHA256 codificado en Base64 de la clave de cifrado. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opcional. Especifica el algoritmo que se va a usar para el cifrado. El valor de este encabezado debe ser AES256. |
|
x-ms-client-request-id |
string |
UuID registrado en los registros de análisis para solucionar problemas y correlación. Patrón de Regex: |
|
x-ms-date |
string |
Especifica la hora universal coordinada (UTC) de la solicitud. Esto es necesario cuando se usa la autorización de clave compartida. |
|
x-ms-version |
string |
Especifica la versión del protocolo REST que se usa para procesar la solicitud. Esto es necesario cuando se usa la autorización de clave compartida. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
file |
Aceptar Media Types: "application/json", "application/octet-stream", "text/plain" Encabezados
|
Other Status Codes |
file |
Contenido parcial Media Types: "application/json", "application/octet-stream", "text/plain" Encabezados
|
Other Status Codes |
Se produjo un error. A continuación se enumeran los posibles estados HTTP, código y cadenas de mensaje:
Media Types: "application/json", "application/octet-stream", "text/plain" Encabezados
|
Definiciones
Nombre | Description |
---|---|
Data |
|
Error |
Objeto de respuesta de error del servicio. |
DataLakeStorageError
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de respuesta de error del servicio. |
Error
Objeto de respuesta de error del servicio.
Nombre | Tipo | Description |
---|---|---|
code |
string |
Código de error del servicio. |
message |
string |
Mensaje de error del servicio. |