az appconfig feature
Manage feature flags stored in an App Configuration store.
Commands
Name | Description | Type | Status |
---|---|---|---|
az appconfig feature delete |
Delete feature flag. |
Core | GA |
az appconfig feature disable |
Disable a feature flag to turn it OFF for use. |
Core | GA |
az appconfig feature enable |
Enable a feature flag to turn it ON for use. |
Core | GA |
az appconfig feature filter |
Manage filters associated with feature flags stored in an App Configuration store. |
Core | GA |
az appconfig feature filter add |
Add a filter to a feature flag. |
Core | GA |
az appconfig feature filter delete |
Delete a filter from a feature flag. |
Core | GA |
az appconfig feature filter list |
List all filters for a feature flag. |
Core | GA |
az appconfig feature filter show |
Show filters of a feature flag. |
Core | GA |
az appconfig feature filter update |
Update a filter in a feature flag. |
Core | GA |
az appconfig feature list |
List feature flags. |
Core | GA |
az appconfig feature lock |
Lock a feature flag to prohibit write operations. |
Core | GA |
az appconfig feature set |
Set a feature flag. |
Core | GA |
az appconfig feature show |
Show all attributes of a feature flag. |
Core | GA |
az appconfig feature unlock |
Unlock a feature to gain write operations. |
Core | GA |
az appconfig feature delete
Delete feature flag.
az appconfig feature delete [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--yes]
Examples
Delete a feature using App Configuration store name without confirmation.
az appconfig feature delete -n MyAppConfiguration --feature color --label MyLabel --yes
Delete a feature using connection string.
az appconfig feature delete --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --label MyLabel
Delete a feature using App Configuration store endpoint and your 'az login' credentials.
az appconfig feature delete --endpoint https://myappconfiguration.azconfig.io --feature color --auth-mode login
Delete a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature delete -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta --yes
Optional Parameters
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.
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.
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>
.
Name of the feature to be deleted. If the feature flag key is different from the default key, provide the --key
argument instead. Support star sign as filters, for instance * means all features and abc* means features with abc as prefix. Comma separated features are not supported. Please provide escaped string if your feature name contains comma.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Support star sign as filters, for instance ".appconfig.featureflag/" means all features and ".appconfig.featureflag/abc" means features with abc as prefix. Comma separated features are not supported. Please provide escaped string if your feature name contains comma.
If no label specified, delete the feature flag with null label by default. Support star sign as filters, for instance * means all labels and abc* means labels with abc as prefix.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature disable
Disable a feature flag to turn it OFF for use.
az appconfig feature disable [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--yes]
Examples
disable a feature using App Configuration store name.
az appconfig feature disable -n MyAppConfiguration --feature color --label test
Force disabling a feature using connection string.
az appconfig feature disable --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --label test --yes
Disable a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature disable -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
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>
.
Name of the feature to be disabled. If the feature flag key is different from the default key, provide the --key
argument instead.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, disable the feature flag with null label by default.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature enable
Enable a feature flag to turn it ON for use.
az appconfig feature enable [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--yes]
Examples
enable a feature using App Configuration store name.
az appconfig feature enable -n MyAppConfiguration --feature color --label test
Force enabling a feature using connection string.
az appconfig feature enable --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --label test --yes
Enable a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature enable -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
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>
.
Name of the feature to be enabled. If the feature flag key is different from the default key, provide the --key
argument instead.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, enable the feature flag with null label by default.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature list
List feature flags.
az appconfig feature list [--all]
[--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--fields {conditions, description, key, label, last_modified, locked, name, state}]
[--key]
[--label]
[--name]
[--top]
Examples
List all feature flags.
az appconfig feature list -n MyAppConfiguration
List all feature flags with null labels.
az appconfig feature list -n MyAppConfiguration --label \0
List a specific feature for any label start with v1. using connection string.
az appconfig feature list --feature color --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --label v1.*
List all features with any labels and query only key, state and conditions.
az appconfig feature list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --fields key state conditions
List 150 feature flags with any labels.
az appconfig feature list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --top 150
List feature flags with multiple labels.
az appconfig feature list --label test,prod,\0 -n MyAppConfiguration
List all features starting with "MyApp1".
az appconfig feature list -n MyAppConfiguration --key .appconfig.featureflag/MyApp1*
Optional Parameters
List all feature flags.
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.
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.
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>
.
Name of the feature to be listed. If the feature flag key is different from the default key, provide the --key
argument instead. Support star sign as filters, for instance * means all features and abc* means features with abc as prefix. Comma separated features are not supported. Please provide escaped string if your feature name contains comma.
Customize output fields for Feature Flags.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Support star sign as filters, for instance ".appconfig.featureflag/" means all features and ".appconfig.featureflag/abc" means features with abc as prefix. Comma separated features are not supported. Please provide escaped string if your feature name contains comma.
If no label specified, list all labels. Support star sign as filters, for instance * means all labels and abc* means labels with abc as prefix. Use '\0' for null label.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Maximum number of items to return. Must be a positive integer. Default to 100.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature lock
Lock a feature flag to prohibit write operations.
az appconfig feature lock [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--yes]
Examples
Lock a feature using App Configuration store name.
az appconfig feature lock -n MyAppConfiguration --feature color --label test
Force locking a feature using connection string.
az appconfig feature lock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --label test --yes
Lock a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature lock -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
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>
.
Name of the feature to be locked. If the feature flag key is different from the default key, provide the --key
argument instead.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, lock the feature flag with null label by default.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature set
Set a feature flag.
az appconfig feature set [--auth-mode {key, login}]
[--connection-string]
[--description]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--requirement-type {all, any}]
[--yes]
Examples
Set a feature flag with label MyLabel.
az appconfig feature set -n MyAppConfiguration --feature color --label MyLabel
Set a feature flag with null label using connection string and set a description.
az appconfig feature set --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --description "This is a colorful feature"
Set a feature flag using your 'az login' credentials.
az appconfig feature set --endpoint https://myappconfiguration.azconfig.io --feature color --label MyLabel --auth-mode login
Set a feature flag with name "Beta" and custom key ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature set -n MyAppConfiguration --feature Beta --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
Description of the feature flag to be set.
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>
.
Name of the feature flag to be set. Feature name cannot contain the '%' character.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, set the feature flag with null label by default.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Requirement type determines if filters should use "Any" or "All" logic when evaluating the state of a feature.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature show
Show all attributes of a feature flag.
az appconfig feature show [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--fields {conditions, description, key, label, last_modified, locked, name, state}]
[--key]
[--label]
[--name]
Examples
Show a feature flag using App Configuration store name with a specific label
az appconfig feature show -n MyAppConfiguration --feature color --label MyLabel
Show a feature flag using connection string and field filters
az appconfig feature show --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --fields key locked conditions state
Show a feature flag using App Configuration store endpoint and your 'az login' credentials.
az appconfig feature show --endpoint https://myappconfiguration.azconfig.io --feature color --auth-mode login
Show a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature show -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
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>
.
Name of the feature flag to be retrieved. If the feature flag key is different from the default key, provide the --key
argument instead.
Customize output fields for Feature Flags.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, show entry with null label. Filtering is not supported.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
az appconfig feature unlock
Unlock a feature to gain write operations.
az appconfig feature unlock [--auth-mode {key, login}]
[--connection-string]
[--endpoint]
[--feature]
[--key]
[--label]
[--name]
[--yes]
Examples
Unlock a feature using App Configuration store name.
az appconfig feature unlock -n MyAppConfiguration --feature color --label test
Force unlocking a feature using connection string.
az appconfig feature unlock --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --label test --yes
Unlock a feature whose name is "Beta" but key is ".appconfig.featureflag/MyApp1:Beta".
az appconfig feature unlock -n MyAppConfiguration --key .appconfig.featureflag/MyApp1:Beta
Optional Parameters
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.
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.
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>
.
Name of the feature to be unlocked. If the feature flag key is different from the default key, provide the --key
argument instead.
Key of the feature flag. Key must start with the ".appconfig.featureflag/" prefix. Key cannot contain the "%" character. If both key and feature arguments are provided, only key will be used. Default key is the reserved prefix ".appconfig.featureflag/" + feature name.
If no label specified, unlock the feature flag with null label by default.
Name of the App Configuration store. You can configure the default name using az configure --defaults app_configuration_store=<name>
.
Do not prompt for confirmation.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.