Path - Read
Ler Arquivo
Leia o conteúdo de um arquivo. Para operações de leitura, há suporte para solicitações de intervalo. Essa operação dá suporte a solicitações HTTP condicionais. Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta do Armazenamento do Azure. |
dns
|
path | True |
string |
O sufixo DNS para o ponto de extremidade Azure Data Lake Storage. |
filesystem
|
path | True |
string |
O identificador do sistema de arquivos. Padrão Regex: |
path
|
path | True |
string |
O caminho do arquivo ou diretório. |
timeout
|
query |
integer int32 |
Um valor de tempo limite de operação opcional em segundos. O período começa quando a solicitação é recebida pelo serviço. Se o valor do tempo limite passar antes da conclusão da operação, a operação falhará. |
Cabeçalho da solicitação
Nome | Obrigatório | Tipo | Description |
---|---|---|---|
Range |
string |
O cabeçalho de solicitação intervalo HTTP especifica um ou mais intervalos de bytes do recurso a ser recuperado. |
|
x-ms-lease-id |
string |
Opcional. Se esse cabeçalho for especificado, a operação será executada somente se ambas as seguintes condições forem atendidas: i) a concessão do caminho estiver ativa no momento e ii) a ID de concessão especificada na solicitação corresponder à do caminho. Padrão Regex: |
|
x-ms-range-get-content-md5 |
boolean |
Opcional. Quando esse cabeçalho é definido como "true" e especificado junto com o cabeçalho Range, o serviço retorna o hash MD5 para o intervalo, desde que o intervalo seja menor ou igual a 4 MB de tamanho. Se esse cabeçalho for especificado sem o cabeçalho Range, o serviço retornará status código 400 (Solicitação Incorreta). Se esse cabeçalho for definido como true quando o intervalo exceder 4 MB de tamanho, o serviço retornará status código 400 (Solicitação Incorreta). |
|
If-Match |
string |
Opcional. Um valor de ETag. Especifique esse cabeçalho para executar a operação somente se a ETag do recurso corresponder ao valor especificado. A ETag deve ser especificada entre aspas. |
|
If-None-Match |
string |
Opcional. Um valor ETag ou o valor curinga especial ("*"). Especifique esse cabeçalho para executar a operação somente se a ETag do recurso não corresponder ao valor especificado. A ETag deve ser especificada entre aspas. |
|
If-Modified-Since |
string |
Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação somente se o recurso tiver sido modificado desde a data e hora especificadas. |
|
If-Unmodified-Since |
string |
Opcional. Um valor de data e hora. Especifique esse cabeçalho para executar a operação somente se o recurso não tiver sido modificado desde a data e hora especificadas. |
|
x-ms-encryption-key |
string |
Opcional. A chave de criptografia AES-256 codificada em Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opcional. O hash SHA256 codificado em Base64 da chave de criptografia. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opcional. Especifica o algoritmo a ser usado para criptografia. O valor desse cabeçalho deve ser AES256. |
|
x-ms-client-request-id |
string |
Uma UUID registrada nos logs de análise para solução de problemas e correlação. Padrão Regex: |
|
x-ms-date |
string |
Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Isso é necessário ao usar a autorização de chave compartilhada. |
|
x-ms-version |
string |
Especifica a versão do protocolo REST usada para processar a solicitação. Isso é necessário ao usar a autorização de chave compartilhada. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
file |
Ok Media Types: "application/json", "application/octet-stream", "text/plain" Cabeçalhos
|
Other Status Codes |
file |
Conteúdo parcial Media Types: "application/json", "application/octet-stream", "text/plain" Cabeçalhos
|
Other Status Codes |
Ocorreu um erro. As possíveis cadeias de caracteres de status HTTP, código e mensagem estão listadas abaixo:
Media Types: "application/json", "application/octet-stream", "text/plain" Cabeçalhos
|
Definições
Nome | Description |
---|---|
Data |
|
Error |
O objeto de resposta de erro de serviço. |
DataLakeStorageError
Nome | Tipo | Description |
---|---|---|
error |
O objeto de resposta de erro de serviço. |
Error
O objeto de resposta de erro de serviço.
Nome | Tipo | Description |
---|---|---|
code |
string |
O código de erro do serviço. |
message |
string |
A mensagem de erro do serviço. |