Path - Read

  • Riferimento
Servizio:
Storage Services
Versione API:
2023-08-03

Leggere file
Leggere il contenuto di un file. Per le operazioni di lettura, sono supportate le richieste di intervallo. Questa operazione supporta le richieste HTTP condizionali. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio BLOB.

GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}
Con parametri facoltativi: 
GET https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
accountName
 path True

string

Nome dell'account di archiviazione di Azure.
dnsSuffix
 path True

string

Suffisso DNS per l'endpoint di Azure Data Lake Storage.
filesystem
 path True

string

Identificatore del file system.

Criterio di espressione regolare: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
path
 path True

string

Percorso file o directory.
timeout
 query

integer

int32

Valore facoltativo del timeout dell'operazione in secondi. Il periodo inizia quando la richiesta viene ricevuta dal servizio. Se il valore di timeout è trascorso prima del completamento dell'operazione, l'operazione ha esito negativo.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Range

string

L'intestazione della richiesta intervallo HTTP specifica uno o più intervalli di byte della risorsa da recuperare.
x-ms-lease-id

string

facoltativo. Se questa intestazione è specificata, l'operazione verrà eseguita solo se vengono soddisfatte entrambe le condizioni seguenti: i) il lease del percorso è attualmente attivo e ii) l'ID lease specificato nella richiesta corrisponde a quello del percorso.

Criterio di espressione regolare: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-range-get-content-md5

boolean

facoltativo. Quando questa intestazione è impostata su "true" e specificata insieme all'intestazione Range, il servizio restituisce l'hash MD5 per l'intervallo, purché l'intervallo sia minore o uguale a 4 MB di dimensioni. Se questa intestazione viene specificata senza l'intestazione Range, il servizio restituisce il codice di stato 400 (richiesta non valida). Se questa intestazione è impostata su true quando l'intervallo supera le dimensioni di 4 MB, il servizio restituisce il codice di stato 400 (richiesta non valida).
If-Match

string

facoltativo. Valore ETag. Specificare questa intestazione per eseguire l'operazione solo se il valore ETag della risorsa corrisponde al valore specificato. L'ETag deve essere specificato nelle virgolette.
If-None-Match

string

facoltativo. Valore ETag o carattere jolly speciale ("*"). Specificare questa intestazione per eseguire l'operazione solo se il valore ETag della risorsa non corrisponde al valore specificato. L'ETag deve essere specificato nelle virgolette.
If-Modified-Since

string

facoltativo. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa è stata modificata dopo la data e l'ora specificate.
If-Unmodified-Since

string

facoltativo. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa non è stata modificata dopo la data e l'ora specificate.
x-ms-encryption-key

string

facoltativo. Chiave di crittografia AES-256 con codifica Base64.
x-ms-encryption-key-sha256

string

facoltativo. Hash SHA256 con codifica Base64 della chiave di crittografia.
x-ms-encryption-algorithm: AES256

string

facoltativo. Specifica l'algoritmo da usare per la crittografia. Il valore di questa intestazione deve essere AES256.
x-ms-client-request-id

string

Un UUID registrato nei log di analisi per la risoluzione dei problemi e la correlazione.

Criterio di espressione regolare: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
x-ms-date

string

Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Questa operazione è necessaria quando si usa l'autorizzazione della chiave condivisa.
x-ms-version

string

Specifica la versione del protocollo REST utilizzata per l'elaborazione della richiesta. Questa operazione è necessaria quando si usa l'autorizzazione della chiave condivisa.

Risposte

Nome Tipo Descrizione
200 OK

file

OK

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

Intestazioni

  • 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

Contenuto parziale

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

Intestazioni

  • 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

Si è verificato un errore. Di seguito sono elencate le possibili stringhe di stato, codice e messaggio:

  • 400 Richiesta non valida, ContentLengthMustBeZero, "L'intestazione della richiesta Content-Length deve essere zero".
  • 400 Richiesta non valida, InvalidAuthenticationInfo, "Le informazioni di autenticazione non sono fornite nel formato corretto. Controllare il valore dell'intestazione di autorizzazione.
  • 400 Richiesta non valida, InvalidFlushPosition, "I dati caricati non sono contigui o il valore del parametro di query di posizione non è uguale alla lunghezza del file dopo aver aggiunto i dati caricati".
  • 400 Richiesta non valida, InvalidHeaderValue, "Il valore per una delle intestazioni HTTP non è nel formato corretto".
  • 400 Richiesta non valida, InvalidHttpVerb, "Il verbo HTTP specificato non è valido- non è riconosciuto dal server".
  • 400 Richiesta non valida, InvalidInput, "Uno degli input della richiesta non è valido".
  • 400 Richiesta non valida, InvalidPropertyName, "Il nome della proprietà non può essere vuoto".
  • 400 Richiesta non valida, InvalidPropertyName, "Il nome della proprietà contiene caratteri non validi".
  • 400 Richiesta non valida, InvalidQueryParameterValue, "Valore per uno dei parametri di query specificati nell'URI della richiesta non è valido".
  • 400 Richiesta non valida, InvalidResourceName, "Il nome della risorsa specificato contiene caratteri non validi".
  • 400 Richiesta non valida, InvalidSourceUri, "L'URI di origine non è valido".
  • 400 Richiesta non valida, InvalidUri, "L'URI della richiesta non è valido".
  • 400 Richiesta non valida, MissingRequiredHeader, "Intestazione HTTP obbligatoria per questa richiesta non specificata".
  • 400 Richiesta non valida, MissingRequiredQueryParameter, "Parametro di query obbligatorio per questa richiesta non specificato".
  • 400 Richiesta non valida, MultipleConditionHeadersNotSupported, "Non sono supportate più intestazioni di condizione".
  • 400 Richiesta non valida, OutOfRangeInput, "Uno degli input della richiesta non è compreso nell'intervallo".
  • 400 Richiesta non valida, OutOfRangeQueryParameterValue, "Uno dei parametri di query specificati nell'URI della richiesta non è compreso nell'intervallo consentito".
  • 400 Richiesta non valida, UnsupportedHeader, "Una delle intestazioni specificate nella richiesta non è supportata".
  • 400 Richiesta non valida, Non supportatoQueryParameter, "Uno dei parametri di query specificati nell'URI della richiesta non è supportato".
  • 400 Richiesta non valida, Non supportatoRestVersion, "La versione rest specificata non è supportata".
  • 403 Non consentito, AccountIsDisabled, "L'account specificato è disabilitato".
  • 403 Non consentito, AuthorizationFailure, "Questa richiesta non è autorizzata a eseguire questa operazione".
  • 403 Non consentito, InsufficientiAccountPermissions, "L'account a cui si accede non dispone di autorizzazioni sufficienti per eseguire questa operazione".
  • 404 Not Found, FilesystemNotFound, "Il file system specificato non esiste".
  • 404 Not Found, PathNotFound, "Il percorso specificato non esiste".
  • 404 Not Found, RenameDestinationParentPathNotFound, "La directory padre del percorso di destinazione non esiste".
  • 404 Not Found, ResourceNotFound, "La risorsa specificata non esiste".
  • 404 Not Found, SourcePathNotFound, "Percorso di origine per un'operazione di ridenominazione non esiste".
  • Metodo 405 Non consentito, Non supportatoHttpVerb, "La risorsa non supporta il verbo HTTP specificato".
  • 409 Conflitto, DestinationPathIsBeingDeleted, "Il percorso di destinazione specificato è contrassegnato per essere eliminato".
  • 409 Conflict, DirectoryNotEmpty, "Il valore del parametro di query ricorsivo deve essere true per eliminare una directory non vuota".
  • 409 Conflitto, FilesystemAlreadyExists, "Il file system specificato esiste già".
  • 409 Conflitto, FilesystemBeingDeleted, "Il file system specificato viene eliminato".
  • 409 Conflict, InvalidDestinationPath, "Il percorso specificato o un elemento del percorso, esiste e il relativo tipo di risorsa non è valido per questa operazione". * 409 Conflitto, InvalidFlushOperation, "La risorsa è stata creata o modificata dall'API del servizio BLOB e non può essere scritta dall'API del servizio Data Lake Storage".
  • 409 Conflict, InvalidRenameSourcePath, "La directory di origine non può essere uguale alla directory di destinazione, né può essere una sottodirectory della directory di origine".
  • 409 Conflitto, InvalidSourceOrDestinationResourceType, "Il tipo di risorsa di origine e di destinazione deve essere identico".
  • 409 Conflitto, LeaseAlreadyPresent, "Esiste già un lease presente".
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "L'ID lease specificato non corrispondeva all'ID lease per la risorsa con l'operazione di lease specificata".
  • 409 Conflict, LeaseIsAlreadyBroken, "Il lease è già stato interrotto e non può essere interrotto di nuovo".
  • 409 Conflitto, LeaseIsBreakingAndCannotBeAcquired, "L'ID lease corrisponde, ma il lease è attualmente in stato di interruzione e non può essere acquisito fino a quando non viene interrotto".
  • 409 Conflict, LeaseIsBreakingAndCannotBeChanged, "L'ID lease corrisponde, ma il lease è attualmente in stato di interruzione e non può essere modificato".
  • 409 Conflitto, LeaseIsBrokenAndCannotBeRenewed, "L'ID lease corrisponde, ma il lease è stato interrotto in modo esplicito e non può essere rinnovato".
  • 409 Conflict, LeaseNameMismatch, "Il nome del lease specificato non corrisponde al nome del lease esistente".
  • 409 Conflict, LeaseNotPresentWithLeaseOperation, "L'ID lease non è presente con l'operazione di lease specificata".
  • 409 Conflitto, PathAlreadyExists, "Il percorso specificato esiste già".
  • 409 Conflict, PathConflict, "Il percorso specificato o un elemento del percorso, esiste e il relativo tipo di risorsa non è valido per questa operazione".
  • 409 Conflict, SourcePathIsBeingDeleted, "Il percorso di origine specificato è contrassegnato per essere eliminato".
  • 409 Conflict, ResourceTypeMismatch, "Il tipo di risorsa specificato nella richiesta non corrisponde al tipo di risorsa".
  • 412 Precondizione non riuscita, ConditionNotMet, "La condizione specificata usando intestazioni condizionali HTTP non viene soddisfatta".
  • 412 Precondizione non riuscita, LeaseIdMismatch, "L'ID lease specificato non corrisponde all'ID lease per la risorsa".
  • 412 Precondizione non riuscita, LeaseIdMissing, "Attualmente è presente un lease sulla risorsa e non è stato specificato alcun ID lease nella richiesta".
  • 412 Precondizione non riuscita, LeaseNotPresent, "Attualmente non è disponibile alcun lease sulla risorsa".
  • 412 Precondizione non riuscita, LeaseLost, "È stato specificato un ID lease, ma il lease per la risorsa è scaduto".
  • 412 Precondizione non riuscita, SourceConditionNotMet, "La condizione di origine specificata usando intestazioni condizionali HTTP non viene soddisfatta".
  • 413 Entità richiesta troppo grande, RequestBodyTooLarge, "Il corpo della richiesta è troppo grande e supera il limite massimo consentito".
  • 416 Intervallo richiesto non Satisfiable, InvalidRange, "L'intervallo specificato non è valido per le dimensioni correnti della risorsa".
  • 500 Errore interno del server, InternalError, "Il server ha rilevato un errore interno. Ritentare la richiesta"
  • 500 Errori del server interno, OperationTimedOut, "Impossibile completare l'operazione entro il tempo consentito".
  • 503 Service Unavailable, ServerBusy, "Egress è oltre il limite di account".
  • 503 Service Non disponibile, ServerBusy, "Ingress è superiore al limite di account".
  • 503 Servizio Non disponibile, ServerBusy, "Le operazioni al secondo superano il limite di account".
  • Servizio 503 Non disponibile, ServerBusy, "Il server non è attualmente in grado di ricevere le richieste. Riprovare la richiesta."

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

Intestazioni

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

Definizioni

Nome Descrizione
DataLakeStorageError
Error

Oggetto risposta di errore del servizio.

DataLakeStorageError

Nome Tipo Descrizione
error

Error

Oggetto risposta di errore del servizio.

Error

Oggetto risposta di errore del servizio.

Nome Tipo Descrizione
code

string

Codice di errore del servizio.
message

string

Messaggio di errore del servizio.