Share via


az appconfig revision

Manage revisions for key-values stored in an App Configuration store.

Commands

Name Description Type Status
az appconfig revision list

Lists revision history of key-values.

Core GA

az appconfig revision list

Lists revision history of key-values.

az appconfig revision list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--datetime]
                           [--endpoint]
                           [--fields {content_type, etag, key, label, last_modified, locked, tags, value}]
                           [--key]
                           [--label]
                           [--name]
                           [--top]

Examples

List revision history of a key-value using App Configuration store name.

az appconfig revision list -n MyAppConfiguration --key color --label test

List revision history of a key-value with multiple labels.

az appconfig revision list -n MyAppConfiguration --key color --label test,prod,\0

List revision history for key "color" with any labels using connection string

az appconfig revision list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --key color --datetime "2019-05-01T11:24:12Z"

List revision history for all items and query only key, value and last_modified.

az appconfig revision list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --fields key value last_modified

Optional Parameters

--all

List all items.

Default value: False
--auth-mode

This parameter can be used for indicating how a data operation is to be authorized. If the auth mode is "key", provide connection string or store name and your account access keys will be retrieved for authorization. If the auth mode is "login", provide the --endpoint or --name and your "az login" credentials will be used for authorization. You can configure the default auth mode using az configure --defaults appconfig_auth_mode=<auth_mode>. For more information, see https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac.

Accepted values: key, login
Default value: key
--connection-string

Combination of access key and endpoint of the App Configuration store. Can be found using 'az appconfig credential list'. Users can preset it using az configure --defaults appconfig_connection_string=<connection_string> or environment variable with the name AZURE_APPCONFIG_CONNECTION_STRING.

--datetime

Format: "YYYY-MM-DDThh:mm:ssZ". If no time zone specified, use UTC by default.

--endpoint

If auth mode is "login", provide endpoint URL of the App Configuration store. The endpoint can be retrieved using "az appconfig show" command. You can configure the default endpoint using az configure --defaults appconfig_endpoint=<endpoint>.

--fields

Space-separated customized output fields.

Accepted values: content_type, etag, key, label, last_modified, locked, tags, value
--key

If no key specified, return all keys by default. Support star sign as filters, for instance abc* means keys with abc as prefix.

--label

If no label specified, list all labels. Support star sign as filters, for instance abc* means labels with abc as prefix. Use '\0' for null label.

--name -n

Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>.

--top -t

Maximum number of items to return. Must be a positive integer. Default to 100.

Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.