You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-app-configuration/concept-point-time-snapshot.md
+19-13Lines changed: 19 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ author: maud-lv
7
7
ms.author: malev
8
8
ms.service: azure-app-configuration
9
9
ms.topic: conceptual
10
-
ms.date: 02/22/2022
10
+
ms.date: 03/14/2022
11
11
---
12
12
13
13
# Point-in-time snapshot
@@ -23,25 +23,29 @@ You can use the Azure portal or the Azure CLI to retrieve past key-value pairs.
23
23
1. Sign in to the [Azure portal](https://portal.azure.com). Select **All resources**, and select the App Configuration store instance where your key-value pairs are stored.
24
24
25
25
1. In the **Operations** menu, select **Restore**.
26
+
26
27
:::image type="content" source="media/restore-key-value-portal.png" alt-text="Screenshot of the Azure portal, selecting restore":::
27
28
28
-
1. Select **Date: Select date** to select a date and time you want to explore.
29
-
1. Click outside of the date and time fields or press **Tab** to validate your choice. You can now access all the key-value pairs that existed at the selected date, and see how they differ from current keys and values.
29
+
1. Select **Date: Select date** to select a date and time you want to revert to.
30
+
1. Click outside of the date and time fields or press **Tab** to validate your choice. You can now access all the key-value pairs that existed at your selected date and time, and see how they differ from current keys and values. This step helps you understand what keys and values you're preparing to revert to.
31
+
30
32
:::image type="content" source="media/restore-key-value-past-values.png" alt-text="Screenshot of the Azure portal with saved key-value pairs":::
31
33
32
34
The portal displays a table of key-value pairs. The first column includes symbols indicating what will happen if you restore the data for the chosen date and time:
33
-
- The red minus sign (–) means that the key-value pair doesn't exist at that point in time and will be deleted.
34
-
- The green plus sign (+) means that the key-value pair existed then and will be added.
35
-
- The orange bullet sign (•) means that the value was modified since.
35
+
- The red minus sign (–) means that the key-value pair doesn't exist at your selected date and time and will be deleted.
36
+
- The green plus sign (+) means that the key-value pair existed at your selected date and time and will be added.
37
+
- The orange bullet sign (•) means that the key-value pair was modified since your selected date and time. The key will revert to the value it had at the selected date and time.
36
38
37
39
1. Check a box on a line to display the difference between the current and compared key-value pairs and select it for restoring.
40
+
38
41
:::image type="content" source="media/restore-key-value-compare.png" alt-text="Screenshot of the Azure portal with compared keys-value pairs":::
39
42
40
43
In the above example, the preview shows the key TestApp:Settings:BackgroundColor, which currently has a value of #45288E. This value will be modified to #FFF if we go through with restoring the data.
41
44
42
45
You can select one or more checkboxes in the table to take action on the key-value pairs of your choice. You can also select all the checkboxes at the same time to revert all keys-value pairs to a date and time in the past.
43
46
44
47
1. Select **Restore**.
48
+
45
49
:::image type="content" source="media/restore-key-value-confirm.png" alt-text="Screenshot of the Azure portal selecting Restore":::
46
50
47
51
### [Azure CLI](#tab/azure-cli)
@@ -57,8 +61,6 @@ Retrieve all recorded changes to your key-values.
57
61
az appconfig revision list --name <your-app-config-store-name>
58
62
```
59
63
60
-
Retrieve the last 10 recorded changes to your key-values and return only the values for `key`, `label`, and `last_modified` time stamp.
61
-
62
64
Restore all key-values to a specific point in time.
63
65
64
66
```azurecli
@@ -71,28 +73,32 @@ Restore for any label starting with v1. to a specific point in time.
71
73
az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"
72
74
```
73
75
74
-
For more more examples and optional parameters, go to the [Azure CLI documentation](/cli/azure/appconfig/kv).
76
+
For more examples of CLI commands and optional parameters to restore key-value pairs, go to the [Azure CLI documentation](/cli/azure/appconfig/kv).
77
+
78
+
You can also access the history of a specific key-value pair. This feature allows you to check the value of a specific key at a chosen point in time and to revert to a past value without updating any other key-value pair.
75
79
76
80
---
77
81
78
82
## Access the history of a key-value pair
79
83
84
+
> [!TIP]
85
+
> This method is convenient if you have no more than a couple of changes to make, as Configuration explorer only lets you make changes key by key. If you need to restore multiple key-value pairs at once, use the **Restore** menu instead.
86
+
80
87
### [Portal](#tab/azure-portal)
81
88
82
89
You can also access the revision history of a specific key-value pair in the portal.
83
90
84
91
1. In the **Operations** menu, select **Configuration explorer**.
85
92
1. Select **More actions** for the key you want to explore, and then **History**
93
+
86
94
:::image type="content" source="media/explorer-key-history.png" alt-text="Screenshot of the Azure portal selecting key-value history":::
87
95
88
96
You can now see the revision history for the selected key and information about the changes.
89
97
90
-
1. Select Restore to restore the key and value to this point in time.
98
+
1. Select **Restore** to restore the key and value to this point in time.
91
99
92
100
:::image type="content" source="media/explorer-key-day-restore.png" alt-text="Screenshot of the Azure portal viewing key-value data for a specific date":::
93
101
94
-
> [!TIP]
95
-
> This method is convenient if you have no more than a couple of changes to make, as Configuration explorer only lets you make changes key by key. If you need to restore multiple key-value pairs at once, use the **Restore** menu instead.
96
102
97
103
### [Azure CLI](#tab/azure-cli)
98
104
@@ -130,7 +136,7 @@ Retrieve the last 10 recorded changes for the key `color` at a specific point-in
130
136
az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z"
131
137
```
132
138
133
-
For more more examples and optional parameters, go to the [Azure CLI documentation](/cli/azure/appconfig/revision).
139
+
For more examples and optional parameters, go to the [Azure CLI documentation](/cli/azure/appconfig/revision).
0 commit comments