Recupera metadati di file

Articolo
03/29/2023

L'operazione Get File Metadata restituisce tutti i metadati definiti dall'utente per il file specificato.

Disponibilità del protocollo

Protocollo di condivisione file abilitato	Disponibile
SMB
NFS

Richiesta

La richiesta Get File Metadata viene definita come indicato di seguito. È consigliabile usare HTTPS.

Metodo	URI richiesta	Versione HTTP
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=metadata`	HTTP/1.1
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=metadata&sharesnapshot=<DateTime>`	HTTP/1.1

Sostituire i componenti del percorso mostrati nell'URI di richiesta con valori personalizzati, come illustrato di seguito:

Componente percorso	Descrizione
`myaccount`	nome dell'account di archiviazione.
`myshare`	Nome della condivisione file.
`mydirectorypath`	Facoltativa. Percorso della directory.
`myfile`	Nome del file.

Per informazioni sulle restrizioni di denominazione del percorso, vedere Condivisioni nome e riferimenti, directory, file e metadati.

Parametri URI

I parametri aggiuntivi seguenti possono essere specificati nell'URI della richiesta:

Parametro	Descrizione
`sharesnapshot`	Facoltativa. Versione 2017-04-17 e successiva. Il `sharesnapshot` parametro è un valore DateTime opaco che, quando presente, specifica lo snapshot di condivisione per eseguire query per i metadati del file.
`timeout`	Facoltativa. Il parametro `timeout` viene espresso in secondi. Per altre informazioni, vedere Impostare 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. 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-lease-id:<ID>`	Facoltativa. Versione 2019-02-02 e successiva. Se l'intestazione è specificata, l'operazione viene eseguita solo se il lease del file è attualmente attivo e l'ID lease specificato nella richiesta corrisponde all'ID lease del file. In caso contrario, l'operazione non riesce con il codice di stato 412 (Precondizione non riuscita).
`x-ms-client-request-id`	Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le 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 usando l'intestazione `Authorization` . Disponibile per la versione 2022-11-02 e versioni successive.
`x-ms-allow-trailing-dot: { <Boolean> }`	Facoltativa. Versione 2022-11-02 e versioni 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 riferimenti a condivisioni, directory, file e metadati.

Testo della richiesta

Nessuno.

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 il codice di stato 202 (Accettato).

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
`Last-Modified`	Restituisce la data e l'ora dell'ultima modifica del file. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentare valori di data/ora nelle intestazioni. Qualsiasi operazione che modifica il file o le relative proprietà aggiorna l'ultima volta modificata.
`x-ms-meta-name:value`	Set di coppie nome-valore contenente le proprietà per il file.
`x-ms-type: <File>`	Restituisce `File` ed è riservata per usi futuri.
`x-ms-request-id`	Identifica in modo univoco la richiesta effettuata e può essere usata per risolvere la richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
`ETag`	Il valore ETag contiene un valore che è possibile utilizzare per eseguire le operazioni in modo condizionale. Il valore è racchiuso tra virgolette.
`x-ms-version`	Versione del servizio usata per eseguire la richiesta.
`Date` o `x-ms-date`	Valore di data/ora UTC generato dal servizio, che indica l'ora in cui è stata avviata la risposta.
`x-ms-client-request-id`	Questa intestazione può essere usata per risolvere le richieste e le 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