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.

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.

   Note

   The duration of the retention period can't be updated once the snapshot has been created.

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.

   Key	Value	Label	Included in snapshot
   app2/bgcolor	Light Gray	label2	No: doesn't start with app1.
   app1/color	Black	No label	No: doesn't have the label label2 or label1.
   app1/color	Blue	label1	Yes: Has the right label label1 from the last of applicable filters.
   app1/color	Green	label2	No: Same key with label label1 selected by the second filter overrides this one though it has the selected label, label2.
   app1/color	Yellow	label3	No: doesn't have the label label2 or label1.
   app1/message	Hello	label1	Yes: Has the right label label1 from the last of applicable filters.
   app1/message	Hi!	label2	No: Same key with label label1 selected by the second filter overrides this one though it has the selected label, label2.
   app2/message	Good morning!	label1	No: doesn't start with app1.

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.

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
});

spring:
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

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.

Next steps