Manage and use snapshots

• 
  

In this article, learn how to create, use and manage snapshots in Azure App Configuration. Snapshot is a set of App Configuration settings stored in an immutable state.

Prerequisites

• An App Configuration store. Create a store.
• "DataOwner" role in the App Configuration store. Details on required role and permissions for snapshots

Add key-values to the App configuration store

In your App Configuration store, go to Operations > Configuration explorer and add the following key-values. Leave Content Type with its default value. For more information about how to add key-values to a store using the Azure portal or the CLI, go to Create a key-value.

Key	Value	Label
app2/bgcolor	Light Gray	label2
app1/color	Black	No label
app1/color	Blue	label1
app1/color	Green	label2
app1/color	Yellow	label3
app1/message	Hello	label1
app1/message	Hi!	label2
app2/message	Good morning!	label1

Create a snapshot

Under Operations > Snapshots, select Create a new snapshot.

1. Enter a snapshot name and optionally also add Tags.

2. Under Choose the composition type, keep the default value Key (default).

   • With the Key composition type, if your store has identical keys with different labels, only the key-value specified in the last applicable filter is included in the snapshot. Identical key-values with other labels are left out of the snapshot.
   • With the Key-Label composition type, if your store has identical keys with different labels, all key-values with identical keys but different labels are included in the snapshot depending on the specified filters.

3. Select Add filters to select the key-values for your snapshot. Filtering is done by selecting filters: Equals, Starts with, Any of and All for keys and for labels. You can enter between one and three filters.

   1. Add the first filter:
      • Under Key, select Starts with and enter app1
      • Under Label, select Equals and select label2 from the drop-down menu.
   2. Add the second filter:
      • Under Key, select Starts with and enter app1
      • Under Label, select Equals and select label1 from the drop-down menu.

4. If you archive a snapshot, by default, it will be retained for 30 days after archival. Optionally, under Recovery options, decrease the number of retention days the snapshot will be available after archival.

    

5. Select Create to generate the snapshot. In this example, the created snapshot has Key composition type and below filters:

   • Keys that start with app1, with label2 label
   • Keys that start with app1, with label1 label.

   

6. Check the table to understand which key-values from the configuration store end up in the snapshot based on the provided parameters.

Create sample snapshots

To create sample snapshots and check how the snapshots feature work, use the snapshot sandbox. This sandbox contains sample data you can play with to better understand how snapshot's composition type and filters work.

1. In Operations > Snapshots > Active snapshots, select Test in sandbox.
2. Review the sample data and practice creating snapshots by filling out the form with a composition type and one or more filters.
3. Select Create to generate the sample snapshot.
4. Check out the snapshot result generated under Generated sample snapshot. The sample snapshot displays all keys that are included in the sample snapshot, according to your selection.

Use snapshots

You can select any number of snapshots for the application's configuration. Selecting a snapshot adds all of its key-values. Once added to a configuration, the key-values from snapshots are treated the same as any other key-value.

If you have an application using Azure App Configuration, you can update it with the following sample code to use snapshots. You only need to provide the name of the snapshot, which is case-sensitive.

• .NET
• Spring

Edit the call to the AddAzureAppConfiguration method, which is often found in the Program.cs file of your application. If you don't have an application, you can reference any of the .NET quickstart guides, like creating an ASP.NET core app with Azure App Configuration.

Add snapshots to your configuration

C#
configurationBuilder.AddAzureAppConfiguration(options =>

{
    options.Connect(Environment.GetEnvironmentVariable("ConnectionString"));

    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

• Microsoft.Extensions.Configuration.AzureAppConfiguration
• Microsoft.Azure.AppConfiguration.AspNetCore
• Microsoft.Azure.AppConfiguration.Functions.Worker

 

Manage active snapshots

The page under Operations > Snapshots displays two tabs: Active snapshots and Archived snapshots. Select Active snapshots to view the list of all active snapshots in an App Configuration store.

View existing snapshot

In the Active snapshots tab, select the ellipsis ... on the right of an existing snapshot and select View to view a snapshot. This action opens a Snapshot details page that displays the snapshot's settings and the key-values included in the snapshot.

Archive a snapshot

In the Active snapshots tab, select the ellipsis ... on the right of an existing snapshot and select Archive to archive a snapshot. Confirm archival by selecting Yes or cancel with No. Once a snapshot has been archived, a notification appears to confirm the operation and the list of active snapshots is updated.

Manage archived snapshots

Go to Operations > Snapshots > Archived snapshots to view the list of all archived snapshots in an App Configuration store. Archived snapshots remain accessible for the retention period that was selected during their creation.

View archived snapshot

Detailed view of snapshot is available in the archive state as well. In the Archived snapshots tab, select the ellipsis ... on the right of an existing snapshot and select View to view a snapshot. This action opens a Snapshot details page that displays the snapshot's settings and the key-values included in the snapshot.

Recover an archived snapshot

In the Archived snapshots tab, select the ellipsis ... on the right of an archived snapshot and select Recover to recover a snapshot. Once a snapshot has been recovered, a notification appears to confirm the operation and the list of archived snapshots is updated.