8.2.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.2.0 - May 14th, 2025

Enhancements

• Updated the existing Select APIs with the new parameter tagFilters to support filtering key-values and feature flags by tags.

  public AzureAppConfigurationOptions Select(string keyFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)

  public FeatureFlagOptions Select(string featureFlagFilter, string labelFilter = LabelFilter.Null, IEnumerable<string> tagFilters = null)

• Added an ActivitySource called Microsoft.Extensions.Configuration.AzureAppConfiguration to support instrumentation. A Load activity will start when configuration is initially built and the Refresh activity will start when a refresh is triggered. #645

• This is the first stable release of the AzureAppConfigurationOptions.SetClientFactory API introduced in 8.2.0-preview. #380

  public AzureAppConfigurationOptions SetClientFactory(IAzureClientFactory<ConfigurationClient> factory)

Other Changes

• Removed the FeatureFlagId property from feature flag telemetry. #655
• Shortened default network timeout for requests to App Configuration to improve failover speed and retry responsiveness. #657
• This is the first stable release of AllocationId from feature flag telemetry metadata, which was introduced in 8.1.0-preview. #600

Microsoft.Azure.AppConfiguration.AspNetCore 8.2.0 - May 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.2.0 - May 14th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0. See the release notes for more information on the changes.

8.1.2

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.2 - April 22nd, 2025

Bug Fixes

• Calling IServiceCollection.AddAzureAppConfiguration now correctly adds an instance of IConfigurationRefresherProvider to the service collection only the first time it is called instead of adding an instance on each invocation. #611

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.2 - April 22nd, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.2. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.2 - April 22nd, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.2. See the release notes for more information on the changes.

8.2.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.2.0-preview - March 21st, 2025

Enhancements

• Added the ability to set a client factory used for creating ConfigurationClient instances. #380

  public AzureAppConfigurationOptions SetClientFactory(IAzureClientFactory<ConfigurationClient> factory)

Microsoft.Azure.AppConfiguration.AspNetCore 8.2.0-preview - March 21st, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.2.0-preview - March 21st, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.2.0-preview. See the release notes for more information on the changes.

8.1.1

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.1 - February 26th, 2025

Bug Fixes

• Fixed a bug introduced in the 8.1.0 release where calls to FeatureFlagOptions.Select were ignored if they were followed by a call to either AzureAppConfigurationOptions.Select or AzureAppConfigurationOptions.SelectSnapshot. #628

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.1 - February 26th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.1. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.1 - February 26th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.1. See the release notes for more information on the changes.

8.1.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.0 - February 24th, 2025

Enhancements

• Added the ability to monitor all selected key-values for refresh with the following new API. #536

  public AzureAppConfigurationRefreshOptions RegisterAll()

  When this API is called, changes to any selected key-values will cause a reload of the configuration.

• Added the ability to check if the type of an IConfigurationSource is AzureAppConfigurationSource with the following new extension. #456

  public static bool IsAzureAppConfigurationSource(this IConfigurationSource source)

Bug Fixes

• Fixed a bug where changing a feature flag would always override an already loaded feature flag with the same key but different label on refresh. As part of this change, feature flags are now always refreshed as a collection, meaning a change in any selected flag will result in a reload of all selected feature flags on refresh. #317
• Fixed a bug where an unnecessary refresh could occur when a request to App Configuration was served from the cache. #588

Other Changes

• Removed support for the configuration_reference property in feature flags. #614
• AllocationId from feature flag telemetry metadata, which was introduced in 8.1.0-preview version, has been removed in this stable version. #600

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.0 - February 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.0 - February 24th, 2025

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0. See the release notes for more information on the changes.

8.1.0-preview

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.1.0-preview - October 24, 2024

Enhancements

• Added support for injecting additional telemetry metadata to feature flags if telemetry is enabled
  • AllocationId represents the version of an allocation on a feature flag. The AllocationId changes when there are essential modifications to the allocation, such as adjustments to the percentile or variant configuration, but not for non-essential changes like feature flag descriptions.

Microsoft.Azure.AppConfiguration.AspNetCore 8.1.0-preview - October 24, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0-preview. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.1.0-preview - October 24, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.1.0-preview. See the release notes for more information on the changes.

8.0.0

8.0.0 - October 3rd, 2024

Breaking Changes

• Increased the default maximum retry count when resolving Key Vault references and increased the minimum refresh interval to 1 minute. This helps prevent requests to Key Vault from being throttled and will reduce the chance of failing to resolve a secret due to momentary failures. #589
• Removed .NET 7 as a target framework as .NET 7 is out of support. #567
• The APIs AzureAppConfigurationRefreshOptions.SetCacheExpiration and FeatureFlagOptions.CacheExpirationInterval have been deprecated and will be removed in a future release. They are replaced with AzureAppConfigurationRefreshOptions.SetRefreshInterval and FeatureFlagOptions.SetRefreshInterval, respectively. This change does not affect functionality but aims to eliminate confusion regarding cache expiration implied by the previous API names. #350

Enhancements

• Variant Feature Flags and Telemetry: This is the first stable release with support for the variants, allocation, and telemetry properties for feature flags added by version 4.0.0 of the Microsoft.FeatureManagement.* libraries. While variant feature flags can still be toggled on or off, they also allow for different configurations, ranging from simple primitives to complex JSON objects. Variant feature flags are particularly useful for feature rollouts, configuration rollouts, and feature experimentation (also known as A/B testing).

• This is the first stable release of the load balancing mode introduced in 8.0.0-preview.3. Load balancing enables your application to distribute requests to App Configuration across all available replicas. This enhancement improves the scalability of applications that typically experience high request volumes to App Configuration, ensuring they remain within quota limits. Load balancing mode is off by default and can be activated by setting the new AzureAppConfigurationOptions.LoadBalancingEnabled property to true. #535

• Added the ability to configure options used to connect to Key Vault resources that have no registered SecretClient with the following new API. #274

  public AzureAppConfigurationKeyVaultOptions ConfigureClientOptions(Action<SecretClientOptions> configure)

  This API can be called from within the AzureAppConfigurationOptions.ConfigureKeyVault method.

8.0.0-preview.3

Microsoft.Extensions.Configuration.AzureAppConfiguration 8.0.0-preview.3 - July 18, 2024

Breaking Changes

• Removed .NET 7 as a target framework as .NET 7 is out of support. #567
• The APIs AzureAppConfigurationRefreshOptions.SetCacheExpiration and FeatureFlagOptions.CacheExpirationInterval have been deprecated and will be removed in a future release. They are replaced with AzureAppConfigurationRefreshOptions.SetRefreshInterval and FeatureFlagOptions.SetRefreshInterval, respectively. This change does not affect functionality but aims to eliminate confusion regarding cache expiration implied by the previous API names. #350

Enhancements

• A load balancing mode has been introduced, enabling your application to distribute requests to App Configuration across all available replicas. This enhancement improves the scalability of applications that typically experience high request volumes to App Configuration, ensuring they remain within quota limits. Load balancing mode is off by default and can be activated by setting the new AzureAppConfigurationOptions.LoadBalancingEnabled property to true. #535
• Variant feature flags are now output using the Microsoft feature flag schema v2.0.0, while the output of configuration for classic feature flags remains unchanged. #543

Microsoft.Azure.AppConfiguration.AspNetCore 8.0.0-preview.3 - July 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.3. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 8.0.0-preview.3 - July 18, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 8.0.0-preview.3. See the release notes for more information on the changes.

7.3.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.3.0 - July 16th, 2024

Enhancements

• Upgraded the package reference for Azure.Security.KeyVault.Secrets to 4.6.0. #572

Bug Fixes

• Loading invalid feature flags should no longer throw an error when TryRefreshAsync is invoked or when the optional argument is true in the AddAzureAppConfiguration method. #551

Microsoft.Azure.AppConfiguration.AspNetCore 7.3.0 - July 16th, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.3.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.3.0 - July 16th, 2024

• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.3.0. See the release notes for more information on the changes.

7.2.0

Microsoft.Extensions.Configuration.AzureAppConfiguration 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Improved JSON key-value deserialization. #537
• Updated Azure.Data.AppConfiguration reference to 1.4.1. #514.

Microsoft.Azure.AppConfiguration.AspNetCore 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.2.0. See the release notes for more information on the changes.

Microsoft.Azure.AppConfiguration.Functions.Worker 7.2.0 - May 2, 2024

Enhancements

• Added support for .NET 8 as a target framework. #530
• Updated Microsoft.Extensions.Configuration.AzureAppConfiguration reference to 7.2.0. See the release notes for more information on the changes.