Skip to content

Commit 741b016

Browse files
committed
add initial tag filters feature info
1 parent b61631e commit 741b016

File tree

2 files changed

+12
-2
lines changed

2 files changed

+12
-2
lines changed

articles/azure-app-configuration/configuration-provider-overview.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ Replica Load Balancing | [GA](./reference-dotnet-provider.md#geo-replication) |
6666
Snapshots | [GA](./reference-dotnet-provider.md#snapshot) | GA | GA | WIP | WIP
6767
Distributed tracing | [GA](./reference-dotnet-provider.md#distributed-tracing) | WIP | WIP | WIP | WIP
6868
Health Check | WIP | WIP | WIP | WIP | WIP
69+
Select by Tag Filters | [GA](./reference-dotnet-provider.md#load-specific-key-values-using-selectors) | WIP | WIP | WIP | WIP
6970

7071
## Support policy
7172

articles/azure-app-configuration/reference-dotnet-provider.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -171,10 +171,12 @@ builder.AddAzureAppConfiguration(options =>
171171
.Select("App:Settings:*")
172172
// Load configuration values with prefix "TestApp:" and "Prod" label
173173
.Select("App:Settings:*", "Prod")
174+
// Load configuration values with prefix "TestApp:" and "Prod" label that have the tag "Group" with value "Contoso"
175+
.Select("App:Settings:*", "Prod", new[] { "Group=Contoso" })
174176
});
175177
```
176178

177-
The `Select` method takes two parameters, the first parameter is a key filter that specifies which keys to load, and the second parameter is a label filter that specifies which key-values with specific labels to load.
179+
The `Select` method takes three parameters. The first parameter is a key filter that specifies which keys to load, the second parameter is a label filter that specifies which key-values with specific labels to load, and the third parameter specifies a collection of tag filters that all must be present on a key-value to load.
178180

179181
> [!NOTE]
180182
> When multiple `Select` calls include overlapping keys, later calls take precedence over earlier ones.
@@ -198,6 +200,13 @@ The label filter parameter selects key-values with a specific label. If not spec
198200
> [!NOTE]
199201
> The characters asterisk (`*`) and comma (`,`), are not supported for label filter. Backslash (`\`) character is reserved and must be escaped using another backslash (`\`).
200202
203+
#### Tag filters
204+
205+
The tag filters parameter selects key-values with specific tags. A key-value is only loaded if it has all of the tags and corresponding values specified in the filters. To specify a null value for a tag, the built-in `TagValue.Null` can be used.
206+
207+
> [!NOTE]
208+
> The characters asterisk (`*`), comma (`,`), and backslash (`\`) are reserved and must be escaped with a backslash when used in a tag filter.
209+
201210
### Trim prefix from keys
202211

203212
When loading configuration values with specific prefixes, you can use the `TrimKeyPrefix` method to remove those prefixes from the keys in your configuration. This creates cleaner configuration keys in your application while maintaining organization in your App Configuration store.
@@ -417,7 +426,7 @@ builder.Configuration.AddAzureAppConfiguration(options =>
417426
});
418427
```
419428

420-
Inside the `UseFeatureFlags` method, you call the `Select` method to selectively load feature flags. You can use [key filter](#key-filter) and [label filter](#label-filter) to select the feature flags you want to load. If no `Select` method is called, `UseFeatureFlags` loads all feature flags with no label by default.
429+
Inside the `UseFeatureFlags` method, you call the `Select` method to selectively load feature flags. You can use [key filter](#key-filter), [label filter](#label-filter), and [tag filters](#tag-filters) to select the feature flags you want to load. If no `Select` method is called, `UseFeatureFlags` loads all feature flags with no label by default.
421430

422431
Different from key-values, feature flags are automatically registered for refresh without requiring explicit `ConfigureRefresh` call. You can specify the minimum time between feature flag refreshes through the `SetRefreshInterval` method. The default refresh interval is 30 seconds.
423432

0 commit comments

Comments
 (0)