Path - Get Properties
Ottenere le proprietà | Ottenere lo stato | Ottenere l'elenco di controllo di accesso | Controllare l'accesso
Get Properties restituisce tutte le proprietà definite dal sistema e dall'utente per un percorso. Get Status restituisce tutte le proprietà definite dal sistema per un percorso. Get Access Control List restituisce l'elenco di controllo di accesso per un percorso. Questa operazione supporta le richieste HTTP condizionali. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio BLOB.
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}
HEAD https://{accountName}.{dnsSuffix}/{filesystem}/{path}?action={action}&upn={upn}&fsAction={fsAction}&timeout={timeout}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di archiviazione di Azure. |
dns
|
path | True |
string |
Suffisso DNS per l'endpoint di Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identificatore del file system. |
path
|
path | True |
string |
Percorso del file o della directory. |
action
|
query |
Opzionale. Se il valore è "getStatus" vengono restituite solo le proprietà definite dal sistema per il percorso. Se il valore è "getAccessControl", l'elenco di controllo di accesso viene restituito nelle intestazioni di risposta (lo spazio dei nomi gerarchico deve essere abilitato per l'account), in caso contrario vengono restituite le proprietà. |
||
fs
|
query |
string |
Obbligatorio solo per controllare l'azione di accesso. Valido solo quando lo spazio dei nomi gerarchico è abilitato per l'account. Operazione di file system di lettura/scrittura/esecuzione in formato stringa, modello regex corrispondente '[rwx-]{3}' |
|
timeout
|
query |
integer (int32) minimum: 1 |
Valore facoltativo di 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. |
|
upn
|
query |
boolean |
Opzionale. Valido solo quando lo spazio dei nomi gerarchico è abilitato per l'account. Se "true", i valori di identità utente restituiti nelle intestazioni di risposta x-ms-owner, x-ms-group e x-ms-acl verranno trasformati dagli ID oggetto di Azure Active Directory ai nomi delle entità utente. Se "false", i valori verranno restituiti come ID oggetto di Azure Active Directory. Il valore predefinito è false. Si noti che gli ID oggetto di gruppo e applicazione non vengono convertiti perché non hanno nomi descrittivi univoci. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Opzionale. Se si specifica questa intestazione, 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. |
|
If-Match |
string |
Opzionale. Un valore ETag. Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-None-Match |
string |
Opzionale. Valore ETag o valore con caratteri jolly speciali ("*"). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-Modified-Since |
string |
Opzionale. 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 |
Opzionale. 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 |
Opzionale. Chiave di crittografia AES-256 con codifica Base64. |
|
x-ms-encryption-key-sha256 |
string |
Opzionale. Hash SHA256 con codifica Base64 della chiave di crittografia. |
|
x-ms-encryption-algorithm: AES256 |
string |
Opzionale. Specifica l'algoritmo da utilizzare per la crittografia. Il valore di questa intestazione deve essere AES256. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
UUID registrato nei log di analisi per la risoluzione dei problemi e la correlazione. |
|
x-ms-date |
string |
Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
|
x-ms-version |
string |
Specifica la versione del protocollo REST usato per l'elaborazione della richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Restituisce tutte le proprietà per il file o la directory. Intestazioni
|
|
Other Status Codes |
Si è verificato un errore. Di seguito sono elencate le possibili stringhe di stato, codice e messaggio HTTP:
Intestazioni
|
Definizioni
Nome | Descrizione |
---|---|
Data |
|
Error |
Oggetto risposta di errore del servizio. |
Path |
Opzionale. Se il valore è "getStatus" vengono restituite solo le proprietà definite dal sistema per il percorso. Se il valore è "getAccessControl", l'elenco di controllo di accesso viene restituito nelle intestazioni di risposta (lo spazio dei nomi gerarchico deve essere abilitato per l'account), in caso contrario vengono restituite le proprietà. |
DataLakeStorageError
Nome | Tipo | Descrizione |
---|---|---|
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. |
PathGetPropertiesAction
Opzionale. Se il valore è "getStatus" vengono restituite solo le proprietà definite dal sistema per il percorso. Se il valore è "getAccessControl", l'elenco di controllo di accesso viene restituito nelle intestazioni di risposta (lo spazio dei nomi gerarchico deve essere abilitato per l'account), in caso contrario vengono restituite le proprietà.
Valore | Descrizione |
---|---|
checkAccess | |
getAccessControl | |
getStatus |