Path - Read
Lire le fichier
Lisez le contenu d’un fichier. Pour les opérations de lecture, les demandes de plage sont prises en charge. Cette opération prend en charge les requêtes HTTP conditionnelles. Pour plus d’informations, consultez Spécification des en-têtes conditionnels pour les opérations du service Blob.
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte stockage Azure. |
dns
|
path | True |
string |
Suffixe DNS du point de terminaison Azure Data Lake Storage. |
filesystem
|
path | True |
string |
Identificateur du système de fichiers. Modèle d’expression régulière: |
path
|
path | True |
string |
Chemin du fichier ou du répertoire. |
timeout
|
query |
integer int32 |
Valeur de délai d’expiration de l’opération facultative en secondes. La période commence lorsque la demande est reçue par le service. Si la valeur du délai d’expiration s’écoule avant la fin de l’opération, l’opération échoue. |
En-tête de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
Range |
string |
L’en-tête de requête de plage HTTP spécifie une ou plusieurs plages d’octets de la ressource à récupérer. |
|
x-ms-lease-id |
string |
facultatif. Si cet en-tête est spécifié, l’opération n’est effectuée que si les deux conditions suivantes sont remplies : i) le bail du chemin d’accès est actuellement actif et ii) l’ID de bail spécifié dans la demande correspond à celui du chemin d’accès. Modèle d’expression régulière: |
|
x-ms-range-get-content-md5 |
boolean |
facultatif. Lorsque cet en-tête est défini sur « true » et spécifié avec l’en-tête Range, le service retourne le hachage MD5 pour la plage, tant que la plage est inférieure ou égale à 4 Mo. Si cet en-tête est spécifié sans l’en-tête Range, le service retourne status code 400 (requête incorrecte). Si cet en-tête a la valeur true lorsque la taille de la plage dépasse 4 Mo, le service retourne status code 400 (requête incorrecte). |
|
If-Match |
string |
facultatif. Spécifiez une valeur ETag. Spécifiez cet en-tête pour exécuter l'opération uniquement si l'ETag de la ressource correspond à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-None-Match |
string |
facultatif. Valeur ETag ou valeur générique spéciale (« * »). Spécifiez cet en-tête pour exécuter l'opération uniquement si l'ETag de la ressource ne correspond pas à la valeur spécifiée. L’ETag doit être spécifié entre guillemets. |
|
If-Modified-Since |
string |
facultatif. Valeur de date et heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource a été modifiée depuis la date et l’heure spécifiées. |
|
If-Unmodified-Since |
string |
facultatif. Valeur de date et heure. Spécifiez cet en-tête pour effectuer l’opération uniquement si la ressource n’a pas été modifiée depuis la date et l’heure spécifiées. |
|
x-ms-encryption-key |
string |
facultatif. Clé de chiffrement AES-256 encodée en Base64. |
|
x-ms-encryption-key-sha256 |
string |
facultatif. Hachage SHA256 encodé en Base64 de la clé de chiffrement. |
|
x-ms-encryption-algorithm: AES256 |
string |
facultatif. Spécifie l’algorithme à utiliser pour le chiffrement. La valeur de cet en-tête doit être AES256. |
|
x-ms-client-request-id |
string |
Un UUID enregistré dans les journaux d’analyse pour la résolution des problèmes et la corrélation. Modèle d’expression régulière: |
|
x-ms-date |
string |
Spécifie la date/heure en temps universel coordonné (UTC) pour la requête. Cela est obligatoire lors de l’utilisation de l’autorisation de clé partagée. |
|
x-ms-version |
string |
Spécifie la version du protocole REST utilisé pour le traitement de la demande. Cela est obligatoire lors de l’utilisation de l’autorisation de clé partagée. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
file |
OK Media Types: "application/json", "application/octet-stream", "text/plain" En-têtes
|
Other Status Codes |
file |
Contenu partiel Media Types: "application/json", "application/octet-stream", "text/plain" En-têtes
|
Other Status Codes |
Une erreur est survenue. Les status HTTP possibles, le code et les chaînes de message sont répertoriés ci-dessous :
Media Types: "application/json", "application/octet-stream", "text/plain" En-têtes
|
Définitions
Nom | Description |
---|---|
Data |
|
Error |
Objet de réponse d’erreur de service. |
DataLakeStorageError
Nom | Type | Description |
---|---|---|
error |
Objet de réponse d’erreur de service. |
Error
Objet de réponse d’erreur de service.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur du service. |
message |
string |
Message d’erreur du service. |