Freigeben über


az appconfig snapshot

Verwalten von Momentaufnahmen, die einem App-Konfigurationsspeicher zugeordnet sind.

Befehle

Name Beschreibung Typ Status
az appconfig snapshot archive

Archivieren sie eine Momentaufnahme.

Core Allgemein verfügbar
az appconfig snapshot create

Erstellen Sie eine App-Konfigurationsmomentaufnahme.

Core Allgemein verfügbar
az appconfig snapshot list

Auflisten von Momentaufnahmen.

Core Allgemein verfügbar
az appconfig snapshot recover

Wiederherstellen einer archivierten Momentaufnahme.

Core Allgemein verfügbar
az appconfig snapshot show

Zeigt alle Attribute einer App-Konfigurationsmomentaufnahme an.

Core Allgemein verfügbar

az appconfig snapshot archive

Archivieren sie eine Momentaufnahme.

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

Beispiele

Archivaufnahme "MySnapshot" im Konfigurationsspeicher "MyAppConfiguration".

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

Erforderliche Parameter

--snapshot-name -s

Name der App-Konfigurationsmomentaufnahme.

Optionale Parameter

--auth-mode

Dieser Parameter kann verwendet werden, um anzugeben, wie ein Datenvorgang autorisiert werden soll. Wenn der Authentifizierungsmodus "Schlüssel" ist, stellen Sie Verbindungszeichenfolge oder Speichernamen bereit, und Ihre Kontozugriffsschlüssel werden zur Autorisierung abgerufen. Wenn der Authentifizierungsmodus "Login" ist, geben Sie die --endpoint Anmeldeinformationen oder --name ihre "az login" zur Autorisierung an. Sie können den Standardauthentifizierungsmodus mithilfe von az configure --defaults appconfig_auth_mode=<auth_mode>. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Zulässige Werte: key, login
Standardwert: key
--connection-string

Kombination aus Zugriffstaste und Endpunkt des App-Konfigurationsspeichers. Finden Sie unter "az appconfig-Anmeldeinformationsliste". Benutzer können sie mithilfe az configure --defaults appconfig_connection_string=<connection_string> oder Umgebungsvariablen mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING voreinstellen.

--endpoint

Wenn der Authentifizierungsmodus "Login" lautet, geben Sie die Endpunkt-URL des App-Konfigurationsspeichers an. Der Endpunkt kann mit dem Befehl "az appconfig show" abgerufen werden. Sie können den Standardendpunkt mithilfe von az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Name des App-Konfigurationsspeichers. Sie können den Standardnamen mithilfe von az configure --defaults app_configuration_store=<name>.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az appconfig snapshot create

Erstellen Sie eine App-Konfigurationsmomentaufnahme.

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

Beispiele

Erstellen Sie eine Momentaufnahme von "MySnapshot" aller Schlüssel, die mit "Test" im Konfigurationsspeicher "MyAppConfiguration" beginnen.

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

Erstellen Sie eine Momentaufnahme von MySnapshot aller Schlüssel, beginnend mit "abc" und einem Aufbewahrungszeitraum von 1 Stunde.

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

Erstellen Sie eine Momentaufnahme aller Schlüssel, beginnend mit "app/" und ohne Bezeichnung als Standard, und überschreiben Sie dann die Schlüsselwerte mit Schlüsseln mit der Bezeichnung "prod", falls vorhanden.

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

Erforderliche Parameter

--filters

Durch leer getrennte Liste mit ESCAPE-JSON-Objekten, die die Schlüssel- und Bezeichnungsfilter darstellen, die zum Erstellen einer App-Konfigurationsmomentaufnahme verwendet werden.

--snapshot-name -s

Name der App-Konfigurationsmomentaufnahme.

Optionale Parameter

--auth-mode

Dieser Parameter kann verwendet werden, um anzugeben, wie ein Datenvorgang autorisiert werden soll. Wenn der Authentifizierungsmodus "Schlüssel" ist, stellen Sie Verbindungszeichenfolge oder Speichernamen bereit, und Ihre Kontozugriffsschlüssel werden zur Autorisierung abgerufen. Wenn der Authentifizierungsmodus "Login" ist, geben Sie die --endpoint Anmeldeinformationen oder --name ihre "az login" zur Autorisierung an. Sie können den Standardauthentifizierungsmodus mithilfe von az configure --defaults appconfig_auth_mode=<auth_mode>. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Zulässige Werte: key, login
Standardwert: key
--composition-type

Kompositionstyp, der beim Erstellen von App-Konfigurationsmomentaufnahmen verwendet wird. Wenn nicht angegeben, wird standardmäßig der Schlüssel verwendet.

Zulässige Werte: key, key_label
--connection-string

Kombination aus Zugriffstaste und Endpunkt des App-Konfigurationsspeichers. Finden Sie unter "az appconfig-Anmeldeinformationsliste". Benutzer können sie mithilfe az configure --defaults appconfig_connection_string=<connection_string> oder Umgebungsvariablen mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING voreinstellen.

--endpoint

Wenn der Authentifizierungsmodus "Login" lautet, geben Sie die Endpunkt-URL des App-Konfigurationsspeichers an. Der Endpunkt kann mit dem Befehl "az appconfig show" abgerufen werden. Sie können den Standardendpunkt mithilfe von az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Name des App-Konfigurationsspeichers. Sie können den Standardnamen mithilfe von az configure --defaults app_configuration_store=<name>.

--retention-period

Dauer in Sekunden, für die eine Momentaufnahme vor Ablauf archiviert werden kann. Eine Momentaufnahme kann maximal 7 Tage (604.800s) für kostenlose Tierspeicher und 90 Tage (7.776.000s) für Standardspeicher archiviert werden. Wenn angegeben, muss der Aufbewahrungszeitraum mindestens 1 Stunde (3600s) betragen.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...].

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az appconfig snapshot list

Auflisten von Momentaufnahmen.

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]

Beispiele

Listet alle Momentaufnahmen mit Namen auf, die mit dem Präfix "abc" beginnen.

az appconfig snapshot list -s abc* -n MyAppConfiguration

Alle archivierten Momentaufnahmen auflisten.

az appconfig snapshot list --status archived -n MyAppConfiguration

Listet alle Bereitstellungsmomentaufnahmen mit Namen auf, die mit dem Präfix "app" beginnen.

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

Listet alle fehlgeschlagenen Momentaufnahmen und Bereitstellungsmomentaufnahmen auf.

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

Optionale Parameter

--all

Alle Elemente auflisten.

--auth-mode

Dieser Parameter kann verwendet werden, um anzugeben, wie ein Datenvorgang autorisiert werden soll. Wenn der Authentifizierungsmodus "Schlüssel" ist, stellen Sie Verbindungszeichenfolge oder Speichernamen bereit, und Ihre Kontozugriffsschlüssel werden zur Autorisierung abgerufen. Wenn der Authentifizierungsmodus "Login" ist, geben Sie die --endpoint Anmeldeinformationen oder --name ihre "az login" zur Autorisierung an. Sie können den Standardauthentifizierungsmodus mithilfe von az configure --defaults appconfig_auth_mode=<auth_mode>. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Zulässige Werte: key, login
Standardwert: key
--connection-string

Kombination aus Zugriffstaste und Endpunkt des App-Konfigurationsspeichers. Finden Sie unter "az appconfig-Anmeldeinformationsliste". Benutzer können sie mithilfe az configure --defaults appconfig_connection_string=<connection_string> oder Umgebungsvariablen mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING voreinstellen.

--endpoint

Wenn der Authentifizierungsmodus "Login" lautet, geben Sie die Endpunkt-URL des App-Konfigurationsspeichers an. Der Endpunkt kann mit dem Befehl "az appconfig show" abgerufen werden. Sie können den Standardendpunkt mithilfe von az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Anpassen von Ausgabefeldern für Momentaufnahmen.

Zulässige Werte: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Name des App-Konfigurationsspeichers. Sie können den Standardnamen mithilfe von az configure --defaults app_configuration_store=<name>.

--snapshot-name -s

Wenn kein Name angegeben ist, geben Sie standardmäßig alle Momentaufnahmen zurück. Unterstützen Sie sternzeichen als Filter, z. B. abc* bedeutet Momentaufnahmen mit abc als Präfix für den Namen.

Standardwert: *
--status

Filtert Momentaufnahmen nach ihrem Status. Wenn kein Status angegeben ist, geben Sie standardmäßig alle Momentaufnahmen zurück.

Zulässige Werte: archived, failed, provisioning, ready
--top -t

Maximale Anzahl der zurückzugebenden Elemente. Der Wert muss eine positive ganze Zahl sein. Standardmäßig 100.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az appconfig snapshot recover

Wiederherstellen einer archivierten Momentaufnahme.

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

Beispiele

Wiederherstellen der Momentaufnahme "MySnapshot" im Konfigurationsspeicher "MyAppConfiguration".

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

Erforderliche Parameter

--snapshot-name -s

Name der App-Konfigurationsmomentaufnahme.

Optionale Parameter

--auth-mode

Dieser Parameter kann verwendet werden, um anzugeben, wie ein Datenvorgang autorisiert werden soll. Wenn der Authentifizierungsmodus "Schlüssel" ist, stellen Sie Verbindungszeichenfolge oder Speichernamen bereit, und Ihre Kontozugriffsschlüssel werden zur Autorisierung abgerufen. Wenn der Authentifizierungsmodus "Login" ist, geben Sie die --endpoint Anmeldeinformationen oder --name ihre "az login" zur Autorisierung an. Sie können den Standardauthentifizierungsmodus mithilfe von az configure --defaults appconfig_auth_mode=<auth_mode>. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Zulässige Werte: key, login
Standardwert: key
--connection-string

Kombination aus Zugriffstaste und Endpunkt des App-Konfigurationsspeichers. Finden Sie unter "az appconfig-Anmeldeinformationsliste". Benutzer können sie mithilfe az configure --defaults appconfig_connection_string=<connection_string> oder Umgebungsvariablen mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING voreinstellen.

--endpoint

Wenn der Authentifizierungsmodus "Login" lautet, geben Sie die Endpunkt-URL des App-Konfigurationsspeichers an. Der Endpunkt kann mit dem Befehl "az appconfig show" abgerufen werden. Sie können den Standardendpunkt mithilfe von az configure --defaults appconfig_endpoint=<endpoint>.

--name -n

Name des App-Konfigurationsspeichers. Sie können den Standardnamen mithilfe von az configure --defaults app_configuration_store=<name>.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az appconfig snapshot show

Zeigt alle Attribute einer App-Konfigurationsmomentaufnahme an.

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]

Beispiele

Anzeigen einer App-Konfigurationsmomentaufnahme mit dem Namen "MySnapshot" im Konfigurationsspeicher "MyAppConfiguration".

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

Erforderliche Parameter

--snapshot-name -s

Name der App-Konfigurationsmomentaufnahme.

Optionale Parameter

--auth-mode

Dieser Parameter kann verwendet werden, um anzugeben, wie ein Datenvorgang autorisiert werden soll. Wenn der Authentifizierungsmodus "Schlüssel" ist, stellen Sie Verbindungszeichenfolge oder Speichernamen bereit, und Ihre Kontozugriffsschlüssel werden zur Autorisierung abgerufen. Wenn der Authentifizierungsmodus "Login" ist, geben Sie die --endpoint Anmeldeinformationen oder --name ihre "az login" zur Autorisierung an. Sie können den Standardauthentifizierungsmodus mithilfe von az configure --defaults appconfig_auth_mode=<auth_mode>. Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Zulässige Werte: key, login
Standardwert: key
--connection-string

Kombination aus Zugriffstaste und Endpunkt des App-Konfigurationsspeichers. Finden Sie unter "az appconfig-Anmeldeinformationsliste". Benutzer können sie mithilfe az configure --defaults appconfig_connection_string=<connection_string> oder Umgebungsvariablen mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING voreinstellen.

--endpoint

Wenn der Authentifizierungsmodus "Login" lautet, geben Sie die Endpunkt-URL des App-Konfigurationsspeichers an. Der Endpunkt kann mit dem Befehl "az appconfig show" abgerufen werden. Sie können den Standardendpunkt mithilfe von az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Anpassen von Ausgabefeldern für Momentaufnahmen.

Zulässige Werte: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

Name des App-Konfigurationsspeichers. Sie können den Standardnamen mithilfe von az configure --defaults app_configuration_store=<name>.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.