Condividi tramite

az storage file metadata

  • Riferimento

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire i metadati dei file.

Comandi

Nome Descrizione Tipo Status
az storage file metadata show

Restituisce tutti i metadati definiti dall'utente per il file.

 Core Disponibilità generale
az storage file metadata show (storage-preview estensione)

Restituisce tutti i metadati definiti dall'utente per il file.

 Estensione Disponibilità generale
az storage file metadata update

Aggiornare i metadati del file.

 Core Disponibilità generale
az storage file metadata update (storage-preview estensione)

Aggiornare i metadati del file.

 Estensione Disponibilità generale

az storage file metadata show

Modifica

Restituisce tutti i metadati definiti dall'utente per il file.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Esempio

Mostra metadati per il file

az storage file metadata show -s MyShare --path /path/to/file

Parametri necessari

--path -p

Percorso del file all'interno della condivisione file.

--share-name -s

Nome della condivisione file.

Parametri facoltativi

--account-key

Chiave dell'account di archiviazione. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

Valori accettati: key, login
--backup-intent --enable-file-backup-request-intent

Parametro obbligatorio da usare con l'autenticazione OAuth (Azure AD) per i file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Valore predefinito: False
--connection-string

Stringa di connessione dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se true, il punto finale verrà tagliato dall'URI di destinazione. Il valore predefinito è False.

Valori accettati: false, true
Valore predefinito: False
--file-endpoint

Endpoint del servizio dati di archiviazione. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Stringa che rappresenta la versione dello snapshot, se applicabile.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage file metadata show (storage-preview estensione)

Restituisce tutti i metadati definiti dall'utente per il file.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Esempio

Mostra metadati per il file

az storage file metadata show -s MyShare --path /path/to/file

Parametri necessari

--path -p

Percorso del file all'interno della condivisione file.

--share-name -s

Nome della condivisione file.

Parametri facoltativi

--account-key

Chiave dell'account di archiviazione. Deve essere usato insieme al nome dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

Valori accettati: key, login
--backup-intent --enable-file-backup-request-intent

Parametro obbligatorio da usare con l'autenticazione OAuth (Azure AD) per i file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Valore predefinito: False
--connection-string

Stringa di connessione dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se true, il punto finale verrà tagliato dall'URI di destinazione. Il valore predefinito è False.

Valori accettati: false, true
Valore predefinito: False
--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Stringa che rappresenta la versione dello snapshot, se applicabile.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage file metadata update

Modifica

Aggiornare i metadati del file.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Esempio

Aggiornare i metadati per il file

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parametri necessari

--path -p

Percorso del file all'interno della condivisione file.

--share-name -s

Nome della condivisione file.

Parametri facoltativi

--account-key

Chiave dell'account di archiviazione. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

Valori accettati: key, login
--backup-intent --enable-file-backup-request-intent

Parametro obbligatorio da usare con l'autenticazione OAuth (Azure AD) per i file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Valore predefinito: False
--connection-string

Stringa di connessione dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se true, il punto finale verrà tagliato dall'URI di destinazione. Il valore predefinito è False.

Valori accettati: false, true
Valore predefinito: False
--file-endpoint

Endpoint del servizio dati di archiviazione. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. È possibile trovare ogni endpoint primario del servizio con az storage account show. Variabile di ambiente: AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Metadati in coppie chiave=valore separate da spazi. In questo modo vengono sovrascritti tutti i metadati esistenti.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione o all'endpoint di servizio. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az storage file metadata update (storage-preview estensione)

Aggiornare i metadati del file.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Esempio

Aggiornare i metadati per il file

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parametri necessari

--path -p

Percorso del file all'interno della condivisione file.

--share-name -s

Nome della condivisione file.

Parametri facoltativi

--account-key

Chiave dell'account di archiviazione. Deve essere usato insieme al nome dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_KEY.

--account-name

Nome dell'account di archiviazione. Variabile di ambiente correlata: AZURE_STORAGE_ACCOUNT. Deve essere usato insieme alla chiave dell'account di archiviazione o a un token di firma di accesso condiviso. Se nessuno dei due elementi è presente, il comando tenterà di eseguire una query sulla chiave dell'account di archiviazione usando l'account Azure autenticato. Se viene eseguito un numero elevato di comandi di archiviazione, è possibile che venga raggiunta la quota api.

--auth-mode

Modalità in cui eseguire il comando. La modalità "login" userà direttamente le credenziali di accesso per l'autenticazione. La modalità "chiave" legacy tenterà di eseguire una query per una chiave dell'account se non vengono forniti parametri di autenticazione per l'account. Variabile di ambiente: AZURE_STORAGE_AUTH_MODE.

Valori accettati: key, login
--backup-intent --enable-file-backup-request-intent

Parametro obbligatorio da usare con l'autenticazione OAuth (Azure AD) per i file. In questo modo verranno ignorati i controlli delle autorizzazioni a livello di file/directory e verrà consentito l'accesso, in base alle azioni di dati consentite, anche se sono presenti elenchi di controllo di accesso per tali file/directory.

Valore predefinito: False
--connection-string

Stringa di connessione dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Se true, il punto finale verrà tagliato dall'URI di destinazione. Il valore predefinito è False.

Valori accettati: false, true
Valore predefinito: False
--metadata

Metadati in coppie chiave=valore separate da spazi. In questo modo vengono sovrascritti tutti i metadati esistenti.

--sas-token

Firma di accesso condiviso. Deve essere usato insieme al nome dell'account di archiviazione. Variabile di ambiente: AZURE_STORAGE_SAS_TOKEN.

--timeout

Timeout della richiesta in secondi. Si applica a ogni chiamata al servizio.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.