az appconfig

Manage App Configurations.

Commands

az appconfig create

Create an App Configuration.

az appconfig credential

Manage credentials for App Configurations.

az appconfig credential list

List access keys of an App Configuration.

az appconfig credential regenerate

Regenerate an access key for an App Configuration.

az appconfig delete

Delete an App Configuration.

az appconfig feature

Manage feature flags stored in an App Configuration.

az appconfig feature delete

Delete feature flag.

az appconfig feature disable

Disable a feature flag to turn it OFF for use.

az appconfig feature enable

Enable a feature flag to turn it ON for use.

az appconfig feature filter

Manage filters associated with feature flags stored in an App Configuration.

az appconfig feature filter add

Add a filter to a feature flag.

az appconfig feature filter delete

Delete a filter from a feature flag.

az appconfig feature filter list

List all filters for a feature flag.

az appconfig feature filter show

Show filters of a feature flag.

az appconfig feature list

List feature flags.

az appconfig feature lock

Lock a feature flag to prohibit write operations.

az appconfig feature set

Set a feature flag.

az appconfig feature show

Show all attributes of a feature flag.

az appconfig feature unlock

Unlock a feature to gain write operations.

az appconfig identity

Managed identities for App Configurations.

az appconfig identity assign

Update managed identities for an App Configuration.

az appconfig identity remove

Remove managed identities for an App Configuration.

az appconfig identity show

Display managed identities for an App Configuration.

az appconfig kv

Manage key-values stored in an App Configuration.

az appconfig kv delete

Delete key-values.

az appconfig kv export

Export configurations to another place from your App Configuration.

az appconfig kv import

Import configurations into your App Configuration from another place.

az appconfig kv list

List key-values.

az appconfig kv lock

Lock a key-value to prohibit write operations.

az appconfig kv restore

Restore key-values.

az appconfig kv set

Set a key-value.

az appconfig kv set-keyvault

Set a keyvault reference.

az appconfig kv show

Show all attributes of a key-value.

az appconfig kv unlock

Unlock a key-value to gain write operations.

az appconfig list

Lists all App Configurations under the current subscription.

az appconfig revision

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

az appconfig revision list

Lists revision history of key-values.

az appconfig show

Show properties of an App Configuration.

az appconfig update

Update an App Configuration.

az appconfig create

Create an App Configuration.

az appconfig create --location
                    --name
                    --resource-group
                    [--assign-identity]
                    [--enable-public-network {false, true}]
                    [--sku {Free, Standard}]
                    [--subscription]

Examples

Create an App Configuration with name, location, sku and resource group.

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard

Create an App Configuration with name, location, sku and resource group with system assigned identity.

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity

Create an App Configuration with name, location, sku and resource group with user assigned identity.

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --sku Standard --assign-identity /subscriptions/<SUBSCRIPTON ID>/resourcegroups/<RESOURCEGROUP>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUserAssignedIdentity

Create an App Configuration with name, location and resource group and enable public network access.

az appconfig create -g MyResourceGroup -n MyAppConfiguration -l westus --enable-public-network

Required Parameters

--location -l

Location. Values from: az account list-locations. You can configure the default location using az configure --defaults location=<location>.

--name -n

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

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--assign-identity

Accept system or user assigned identities separated by spaces. Use '[system]' to refer system assigned identity or a resource id to refer user assigned identity. Use system assigned identity if not specified.

--enable-public-network -e

When true, requests coming from public networks have permission to access this store while private endpoint is enabled. When false, only requests made through Private Links can reach this store.

accepted values: false, true
--sku

The sku of App Configuration.

accepted values: Free, Standard
default value: Standard
--subscription

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

az appconfig delete

Delete an App Configuration.

az appconfig delete --name
                    [--resource-group]
                    [--subscription]
                    [--yes]

Examples

Delete an App Configuration under resource group

az appconfig delete -g MyResourceGroup -n MyAppConfiguration

Required Parameters

--name -n

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

Optional Parameters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

--yes -y

Do not prompt for confirmation.

az appconfig list

Lists all App Configurations under the current subscription.

az appconfig list [--query-examples]
                  [--resource-group]
                  [--subscription]

Examples

List all App Configurations under a resource group

az appconfig list -g MyResourceGroup

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

az appconfig show

Show properties of an App Configuration.

az appconfig show --name
                  [--query-examples]
                  [--resource-group]
                  [--subscription]

Examples

Show properties of an App Configuration

az appconfig show -g MyResourceGroup -n MyAppConfiguration

Required Parameters

--name -n

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

Optional Parameters

--query-examples

Recommend JMESPath string for you. You can copy one of the query and paste it after --query parameter within double quotation marks to see the results. You can add one or more positional keywords so that we can give suggestions based on these key words.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--subscription

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

az appconfig update

Update an App Configuration.

az appconfig update --name
                    [--enable-public-network {false, true}]
                    [--encryption-key-name]
                    [--encryption-key-vault]
                    [--encryption-key-version]
                    [--identity-client-id]
                    [--resource-group]
                    [--sku {Free, Standard}]
                    [--subscription]
                    [--tags]

Examples

Update tags of an App Configuration

az appconfig update -g MyResourceGroup -n MyAppConfiguration --tags key1=value1 key2=value2

Upgrade sku of an App Configuration to standard

az appconfig update -g MyResourceGroup -n MyAppConfiguration --sku Standard

Enable customer encryption key with system assigned identity

az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name myKey --encryption-key-version keyVersion --encryption-key-vault https://keyVaultName.vault.azure.net

Remove customer encryption key

az appconfig update -g MyResourceGroup -n MyAppConfiguration --encryption-key-name ""

Update an App Configuration to enable public network access.

az appconfig update -g MyResourceGroup -n MyAppConfiguration --enable-public-network true

Required Parameters

--name -n

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

Optional Parameters

--enable-public-network -e

When true, requests coming from public networks have permission to access this store while private endpoint is enabled. When false, only requests made through Private Links can reach this store.

accepted values: false, true
--encryption-key-name

The name of the KeyVault key.

--encryption-key-vault

The URI of the KeyVault.

--encryption-key-version

The version of the KeyVault key. Use the latest version by default.

--identity-client-id

Client ID of the managed identity with wrap and unwrap access to encryption key. Use system assigned identity by default.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--sku

The sku of App Configuration.

accepted values: Free, Standard
--subscription

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

--tags

Space-separated tags: key[=value] [key[=value] ...]. Use "" to clear existing tags.