Get Directory Properties
L'operazione Get Directory Properties restituisce tutte le proprietà di sistema per la directory specificata e può essere usata anche per verificare l'esistenza di una directory. I dati restituiti non includono i file nella directory o nelle sottodirectory.
Disponibilità del protocollo
| Protocollo di condivisione file abilitato | Disponibile |
|---|---|
| SMB |
|
| NFS |
|
Richiesta
La richiesta Get Directory Properties può essere costruita come segue. È consigliabile usare HTTPS.
| Metodo | URI richiesta | Versione HTTP |
|---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
Sostituire i componenti del percorso visualizzati nell'URI della richiesta con i propri, come indicato di seguito:
| Componente percorso | Descrizione |
|---|---|
myaccount |
nome dell'account di archiviazione. |
myshare |
Nome della condivisione file. |
myparentdirectorypath |
facoltativo. Percorso della directory padre. |
mydirectory |
Nome della directory. |
Per informazioni sulle restrizioni di denominazione dei percorsi, vedere Nomi e condivisioni di riferimento, directory, file e metadati.
Parametri URI
È possibile specificare i parametri aggiuntivi seguenti nell'URI della richiesta:
| Parametro | Descrizione |
|---|---|
sharesnapshot |
Facoltativa. Versione 2017-04-17 e successive. Il sharesnapshot parametro è un valore DateTime opaco che, quando presente, specifica lo snapshot di condivisione su cui eseguire una query per le proprietà della directory |
timeout |
facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostare i timeout per le operazioni di File di Azure. |
Intestazioni della richiesta
Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:
| Intestazione della richiesta | Descrizione |
|---|---|
Authorization |
Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
Date o x-ms-date |
Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure. |
x-ms-version |
Obbligatorio per tutte le richieste autorizzate, facoltativo per le richieste anonime. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure. |
x-ms-client-request-id |
facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log al momento della configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare File di Azure. |
x-ms-file-request-intent |
Obbligatorio se Authorization l'intestazione specifica un token OAuth. Il valore accettabile è backup. Questa intestazione specifica che l'oggetto Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action o Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve essere concesso se sono inclusi nei criteri di controllo degli accessi in base al ruolo assegnati all'identità autorizzata tramite l'intestazione Authorization . Disponibile per la versione 2022-11-02 e successive. |
x-ms-allow-trailing-dot: { <Boolean> } |
facoltativo. Versione 2022-11-02 e successive. Il valore booleano specifica se un punto finale presente nell'URL della richiesta deve essere tagliato o meno. Per altre informazioni, vedere Denominazione e riferimento a condivisioni, directory, file e metadati. |
Testo della richiesta
Nessuno.
Richiesta di esempio
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codice stato
Un'operazione completata correttamente restituisce 200 (OK).
Per altre informazioni sui codici di stato, vedere Codici di stato e di errore.
Intestazioni di risposta
Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.
| Intestazione risposta | Descrizione |
|---|---|
ETag |
Il valore ETag contiene un valore che è possibile utilizzare per eseguire le operazioni in modo condizionale. Il valore è racchiuso tra virgolette. |
Last-Modified |
Restituisce la data e l'ora dell'ultima modifica della directory. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentare i valori di data/ora nelle intestazioni. Le operazioni sui file all'interno della directory non influiscono sull'ora dell'ultima modifica della directory. |
x-ms-meta-name:value |
Set di coppie nome-valore che contengono metadati per la directory. |
x-ms-request-id |
Restituisce l'identificatore univoco della richiesta, che consente di risolvere i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api. |
x-ms-version |
Indica la versione del servizio utilizzata per eseguire la richiesta. |
Date |
Valore di data/ora UTC generato dal servizio, che indica l'ora di avvio della risposta. |
x-ms-server-encrypted: true/false |
Versione 2017-04-17 e successive. Il valore di questa intestazione è impostato su true se i metadati della directory sono completamente crittografati usando l'algoritmo specificato. Se i metadati non sono crittografati, il valore viene impostato su false. |
x-ms-file-permission-key |
Versione 2019-02-02 e successive. Chiave dell'autorizzazione della directory. |
x-ms-file-attributes |
Versione 2019-02-02 e successive. Attributi del file system nella directory. Per altre informazioni, vedere l'elenco degli attributi disponibili. |
x-ms-file-creation-time |
Versione 2019-02-02 e successive. Valore di data/ora UTC che rappresenta la proprietà dell'ora di creazione per una directory. |
x-ms-file-last-write-time |
Versione 2019-02-02 e successive. Valore di data/ora UTC che rappresenta la proprietà dell'ora di scrittura dell'ultima per la directory. |
x-ms-file-change-time |
Versione 2019-02-02 e successive. Valore di data/ora UTC che rappresenta la proprietà dell'ora di modifica per la directory. |
x-ms-file-file-id |
Versione 2019-02-02 e successive. ID file della directory. |
x-ms-file-parent-id |
Versione 2019-02-02 e successive. ID file padre della directory. |
x-ms-client-request-id |
Può essere usato per risolvere i problemi relativi alle richieste e alle risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id se è presente nella richiesta e il valore non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, non è presente nella risposta. |
Corpo della risposta
Nessuno.
Risposta di esempio
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizzazione
Solo il proprietario dell'account può chiamare questa operazione.
Commenti
Se il percorso di directory specificato non esiste, la richiesta ha esito negativo con codice di stato 404 (Non trovato).