Path - Read
Ler Ficheiro
Leia o conteúdo de um ficheiro. Para operações de leitura, são suportados pedidos de intervalo. Esta operação suporta pedidos HTTP condicionais. Para obter mais informações, veja Especificar Cabeçalhos Condicionais para Operações do Serviço blob.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta de Armazenamento do Azure. |
dns
|
path | True |
string |
O sufixo DNS para o ponto final Azure Data Lake Storage. |
filesystem
|
path | True |
string |
O identificador do sistema de ficheiros. Padrão Regex: |
path
|
path | True |
string |
O caminho do ficheiro ou diretório. |
timeout
|
query |
integer int32 |
Um valor de tempo limite de operação opcional em segundos. O período começa quando o pedido é recebido pelo serviço. Se o valor de tempo limite decorrido antes da conclusão da operação, a operação falhará. |
Cabeçalho do Pedido
Name | Necessário | Tipo | Description |
---|---|---|---|
Range |
string |
O cabeçalho do pedido intervalo HTTP especifica um ou mais intervalos de bytes do recurso a obter. |
|
x-ms-lease-id |
string |
Opcional. Se este cabeçalho for especificado, a operação só será efetuada se ambas as condições seguintes forem cumpridas: i) a concessão do caminho estiver atualmente ativa e ii) o ID de concessão especificado no pedido corresponder ao do caminho. Padrão Regex: |
|
x-ms-range-get-content-md5 |
boolean |
Opcional. Quando este cabeçalho está definido como "verdadeiro" e especificado em conjunto com o cabeçalho Intervalo, o serviço devolve o hash MD5 para o intervalo, desde que o intervalo seja inferior ou igual a 4 MB de tamanho. Se este cabeçalho for especificado sem o cabeçalho Intervalo, o serviço devolve o código de estado 400 (Pedido Incorreto). Se este cabeçalho estiver definido como verdadeiro quando o intervalo exceder 4 MB de tamanho, o serviço devolve o código de estado 400 (Pedido Incorreto). |
|
If-Match |
string |
Opcional. Um valor ETag. Especifique este cabeçalho para executar a operação apenas se o ETag do recurso corresponder ao valor especificado. O ETag tem de ser especificado em aspas. |
|
If-None-Match |
string |
Opcional. Um valor ETag ou o valor de caráter universal especial ("*"). Especifique este cabeçalho para executar a operação apenas se o ETag do recurso não corresponder ao valor especificado. O ETag tem de ser especificado em aspas. |
|
If-Modified-Since |
string |
Opcional. Um valor de data e hora. Especifique este cabeçalho para executar a operação apenas se o recurso tiver sido modificado desde a data e hora especificadas. |
|
If-Unmodified-Since |
string |
Opcional. Um valor de data e hora. Especifique este cabeçalho para executar a operação apenas se o recurso não tiver sido modificado desde a data e hora especificadas. |
|
x-ms-encryption-key |
string |
Opcional. A chave de encriptação AES-256 codificada com Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opcional. O hash SHA256 codificado com Base64 da chave de encriptação. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opcional. Especifica o algoritmo a utilizar para encriptação. O valor deste cabeçalho tem de ser AES256. |
|
x-ms-client-request-id |
string |
Um UUID registado nos registos de análise para resolução de problemas e correlação. Padrão Regex: |
|
x-ms-date |
string |
Especifica a Hora Universal Coordenada (UTC) do pedido. Isto é necessário ao utilizar a autorização de chave partilhada. |
|
x-ms-version |
string |
Especifica a versão do protocolo REST utilizada para processar o pedido. Isto é necessário ao utilizar a autorização de chave partilhada. |
Respostas
Name | 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 cadeias de estado, código e mensagem http possíveis estão listadas abaixo:
Media Types: "application/json", "application/octet-stream", "text/plain" Cabeçalhos
|
Definições
Name | Description |
---|---|
Data |
|
Error |
O objeto de resposta de erro do serviço. |
DataLakeStorageError
Name | Tipo | Description |
---|---|---|
error |
O objeto de resposta de erro do serviço. |
Error
O objeto de resposta de erro do serviço.
Name | Tipo | Description |
---|---|---|
code |
string |
O código de erro do serviço. |
message |
string |
A mensagem de erro do serviço. |