Condividi tramite

az appconfig snapshot

  • Riferimento

Gestire gli snapshot associati a un archivio di configurazione app.

Comandi

Nome Descrizione Tipo Status
az appconfig snapshot archive

Archiviare uno snapshot.

 Core Disponibilità generale
az appconfig snapshot create

Creare uno snapshot di configurazione dell'app.

 Core Disponibilità generale
az appconfig snapshot list

Elencare gli snapshot.

 Core Disponibilità generale
az appconfig snapshot recover

Ripristinare uno snapshot archiviato.

 Core Disponibilità generale
az appconfig snapshot show

Mostra tutti gli attributi di uno snapshot di configurazione dell'app.

 Core Disponibilità generale

az appconfig snapshot archive

Modifica

Archiviare uno snapshot.

az appconfig snapshot archive --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Esempio

Archiviare lo snapshot MySnapshot nell'archivio di configurazione MyAppConfiguration.

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

Parametri necessari

--snapshot-name -s

Nome dello snapshot Configurazione app.

Parametri facoltativi

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare o --endpoint--name e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valori accettati: key, login
Valore predefinito: key
--connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome dell'archivio Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

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 appconfig snapshot create

Modifica

Creare uno snapshot di configurazione dell'app.

az appconfig snapshot create --filters
                             --snapshot-name
                             [--auth-mode {key, login}]
                             [--composition-type {key, key_label}]
                             [--connection-string]
                             [--endpoint]
                             [--name]
                             [--retention-period]
                             [--tags]

Esempio

Creare uno snapshot MySnapshot di tutte le chiavi a partire da "Test" nell'archivio di configurazione MyAppConfiguration.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\"}'

Creare uno snapshot MySnapshot di tutte le chiavi a partire da "abc" e da un periodo di conservazione di 1 ora.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"abc*\"}' --retention-period 3600

Creare uno snapshot di tutte le chiavi a partire da 'app/' e nessuna etichetta come predefinita, quindi eseguire l'override dei valori chiave con le chiavi con l'etichetta 'prod' se presenti.

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"app/*\"}' '{\"key\":\"app/*\", \"label\":\"prod\"}' --composition-type 'key'

Parametri necessari

--filters

Elenco separato da spazi di oggetti JSON preceduti da escape che rappresentano i filtri di chiave e etichetta usati per compilare uno snapshot Configurazione app.

--snapshot-name -s

Nome dello snapshot Configurazione app.

Parametri facoltativi

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare o --endpoint--name e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valori accettati: key, login
Valore predefinito: key
--composition-type

Tipo di composizione utilizzato per la compilazione di snapshot Configurazione app. Se non specificato, il valore predefinito è key.

Valori accettati: key, key_label
--connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome dell'archivio Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--retention-period

Durata in secondi per cui uno snapshot può rimanere archiviato prima della scadenza. Uno snapshot può essere archiviato per un massimo di 7 giorni (604.800) per gli archivi di livello gratuito e 90 giorni (7.776.000) per gli store di livello Standard e Premium. Se specificato, il periodo di conservazione deve essere almeno 1 ora (3600s).

--tags

Tag separati da spazi: key[=value] [key[=value] ...].

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 appconfig snapshot list

Modifica

Elencare gli snapshot.

az appconfig snapshot list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]
                           [--snapshot-name]
                           [--status {archived, failed, provisioning, ready}]
                           [--top]

Esempio

Elencare tutti gli snapshot con nomi che iniziano con il prefisso 'abc'.

az appconfig snapshot list -s abc* -n MyAppConfiguration

Elencare tutti gli snapshot archiviati.

az appconfig snapshot list --status archived -n MyAppConfiguration

Elencare tutti gli snapshot di provisioning con nomi che iniziano con il prefisso 'app'.

az appconfig snapshot list -s app* --status provisioning -n MyAppConfiguration

Elencare tutti gli snapshot con esito negativo e di provisioning.

az appconfig snapshot list --status failed provisioning -n MyAppConfiguration

Parametri facoltativi

--all

Elencare tutti gli elementi.

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare o --endpoint--name e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valori accettati: key, login
Valore predefinito: key
--connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Personalizzare i campi di output per gli snapshot.

Valori accettati: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome dell'archivio Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

--snapshot-name -s

Se non è specificato alcun nome, restituire tutti gli snapshot per impostazione predefinita. Supportare il segno star come filtri, ad esempio abc* significa snapshot con abc come prefisso al nome.

Valore predefinito: *
--status

Filtrare gli snapshot in base al relativo stato. Se non è specificato alcuno stato, restituire tutti gli snapshot per impostazione predefinita.

Valori accettati: archived, failed, provisioning, ready
--top -t

Numero massimo di elementi da restituire. Deve essere un intero positivo. Il valore predefinito è 100.

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 appconfig snapshot recover

Modifica

Ripristinare uno snapshot archiviato.

az appconfig snapshot recover --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

Esempio

Ripristinare lo snapshot MySnapshot nell'archivio di configurazione MyAppConfiguration.

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

Parametri necessari

--snapshot-name -s

Nome dello snapshot Configurazione app.

Parametri facoltativi

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare o --endpoint--name e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valori accettati: key, login
Valore predefinito: key
--connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Nome dell'archivio Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

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 appconfig snapshot show

Modifica

Mostra tutti gli attributi di uno snapshot di configurazione dell'app.

az appconfig snapshot show --snapshot-name
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]

Esempio

Visualizzare uno snapshot di configurazione dell'app con il nome MySnapshot nell'archivio di configurazione MyAppConfiguration.

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

Parametri necessari

--snapshot-name -s

Nome dello snapshot Configurazione app.

Parametri facoltativi

--auth-mode

Questo parametro può essere usato per indicare come un'operazione dati deve essere autorizzata. Se la modalità di autenticazione è "chiave", specificare stringa di connessione o nome dell'archivio e le chiavi di accesso dell'account verranno recuperate per l'autorizzazione. Se la modalità di autenticazione è "login", specificare o --endpoint--name e le credenziali "az login" verranno usate per l'autorizzazione. È possibile configurare la modalità di autenticazione predefinita usando az configure --defaults appconfig_auth_mode=<auth_mode>. Per ulteriori informazioni, vedere https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Valori accettati: key, login
Valore predefinito: key
--connection-string

Combinazione della chiave di accesso e dell'endpoint dell'archivio Configurazione app. È possibile trovare 'az appconfig credential list'. Gli utenti possono impostarlo usando az configure --defaults appconfig_connection_string=<connection_string> o variabile di ambiente con il nome AZURE_APPCONFIG_CONNECTION_STRING.

--endpoint

Se la modalità di autenticazione è "login", specificare l'URL dell'endpoint dell'archivio Configurazione app. L'endpoint può essere recuperato usando il comando "az appconfig show". È possibile configurare l'endpoint predefinito usando az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Personalizzare i campi di output per gli snapshot.

Valori accettati: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Nome dell'archivio Configurazione app. È possibile configurare il nome predefinito usando az configure --defaults app_configuration_store=<name>.

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.