az appconfig feature filter

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

Commands

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 filter add

Add a filter to a feature flag.

az appconfig feature filter add --feature
                                --filter-name
                                [--connection-string]
                                [--filter-parameters]
                                [--index]
                                [--label]
                                [--name]
                                [--subscription]
                                [--yes]

Examples

Add a filter for feature 'color' with label MyLabel with name 'MyFilter' and 2 parameters.

az appconfig feature filter add -n MyAppConfiguration --feature color --label MyLabel --filter-name MyFilter --filter-parameters Name=Value Name2=Value2

Insert a filter at index 2 (zero-based index) for feature 'color' with label MyLabel and filter name 'MyFilter' with no parameters

az appconfig feature filter add -n MyAppConfiguration --feature color --label MyLabel --filter-name MyFilter --index 2

Add a filter with name 'MyFilter' using connection string.

az appconfig feature filter add --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --filter-name MyFilter

Required Parameters

--feature

Name of the feature to which you want to add the filter.

--filter-name

Name of the filter to be added.

Optional Parameters

--connection-string

Combination of access key and endpoint of App Configuration. 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.

--filter-parameters

Space-separated filter parameters in 'name[=value]' format.

--index

Zero-based index in the list of filters where you want to insert the new filter. If no index is specified or index is invalid, filter will be added to the end of the list.

--label

If no label specified, add to the feature flag with null label by default.

--name -n

Name of the App Configuration. You can configure the default name using az configure --defaults app_configuration_store=<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 feature filter delete

Delete a filter from a feature flag.

az appconfig feature filter delete --feature
                                   [--all]
                                   [--connection-string]
                                   [--filter-name]
                                   [--index]
                                   [--label]
                                   [--name]
                                   [--subscription]
                                   [--yes]

Examples

Delete a filter from a feature using App Configuration name without confirmation.

az appconfig feature filter delete -n MyAppConfiguration --feature color --filter-name MyFilter --yes

Delete a filter from a feature when you have multiple filters with that same name.

az appconfig feature filter delete --feature color --filter-name MyFilter --index 2 --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx

Delete all filters of a feature using App Configuration name without confirmation.

az appconfig feature filter delete -n MyAppConfiguration --feature color --label MyLabel --all --yes

Required Parameters

--feature

Name of the feature from which you want to delete the filter.

Optional Parameters

--all

Delete all filters associated with a feature flag.

--connection-string

Combination of access key and endpoint of App Configuration. 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.

--filter-name

Name of the filter to be deleted.

--index

Zero-based index of the filter to be deleted in case there are multiple instances with same filter name.

--label

If no label specified, delete from the feature flag with null label by default.

--name -n

Name of the App Configuration. You can configure the default name using az configure --defaults app_configuration_store=<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 feature filter list

List all filters for a feature flag.

az appconfig feature filter list --feature
                                 [--all]
                                 [--connection-string]
                                 [--label]
                                 [--name]
                                 [--query-examples]
                                 [--subscription]
                                 [--top]

Examples

List all filters for feature flag 'color'.

az appconfig feature filter list -n MyAppConfiguration --feature color --all

List 150 filters for feature flag 'color'

az appconfig feature filter list --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx  --feature color --top 150

Required Parameters

--feature

Name of the feature whose filters you want to be displayed.

Optional Parameters

--all

List all filters associated with a feature flag.

--connection-string

Combination of access key and endpoint of App Configuration. 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.

--label

If no label specified, display filters from the feature flag with null label by default.

--name -n

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

--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.

--subscription

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

--top -t

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

az appconfig feature filter show

Show filters of a feature flag.

az appconfig feature filter show --feature
                                 --filter-name
                                 [--connection-string]
                                 [--index]
                                 [--label]
                                 [--name]
                                 [--query-examples]
                                 [--subscription]

Examples

Show one unique feature filter when you have multiple filters with that same name.

az appconfig feature filter show -n MyAppConfiguration --feature color --filter-name MyFilter --index 2

Show all instances of a feature filter when you have multiple filters with that same name.

az appconfig feature filter show --connection-string Endpoint=https://contoso.azconfig.io;Id=xxx;Secret=xxx --feature color --filter-name MyFilter

Required Parameters

--feature

Name of the feature which contains the filter.

--filter-name

Name of the filter to be displayed.

Optional Parameters

--connection-string

Combination of access key and endpoint of App Configuration. 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.

--index

Zero-based index of the filter to be displayed in case there are multiple instances with same filter name.

--label

If no label specified, show the feature flag with null label by default.

--name -n

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

--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.

--subscription

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