Skip to content

Commit 96770df

Browse files
committed
integrate feedback
1 parent 10cdcd2 commit 96770df

File tree

1 file changed

+19
-13
lines changed

1 file changed

+19
-13
lines changed

articles/azure-app-configuration/concept-point-time-snapshot.md

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: maud-lv
77
ms.author: malev
88
ms.service: azure-app-configuration
99
ms.topic: conceptual
10-
ms.date: 02/22/2022
10+
ms.date: 03/14/2022
1111
---
1212

1313
# Point-in-time snapshot
@@ -23,25 +23,29 @@ You can use the Azure portal or the Azure CLI to retrieve past key-value pairs.
2323
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.
2424

2525
1. In the **Operations** menu, select **Restore**.
26+
2627
:::image type="content" source="media/restore-key-value-portal.png" alt-text="Screenshot of the Azure portal, selecting restore":::
2728

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+
3032
:::image type="content" source="media/restore-key-value-past-values.png" alt-text="Screenshot of the Azure portal with saved key-value pairs":::
3133

3234
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.
3638

3739
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+
3841
:::image type="content" source="media/restore-key-value-compare.png" alt-text="Screenshot of the Azure portal with compared keys-value pairs":::
3942

4043
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.
4144

4245
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.
4346

4447
1. Select **Restore**.
48+
4549
:::image type="content" source="media/restore-key-value-confirm.png" alt-text="Screenshot of the Azure portal selecting Restore":::
4650

4751
### [Azure CLI](#tab/azure-cli)
@@ -57,8 +61,6 @@ Retrieve all recorded changes to your key-values.
5761
az appconfig revision list --name <your-app-config-store-name>
5862
```
5963

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-
6264
Restore all key-values to a specific point in time.
6365

6466
```azurecli
@@ -71,28 +73,32 @@ Restore for any label starting with v1. to a specific point in time.
7173
az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"
7274
```
7375

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.
7579

7680
---
7781

7882
## Access the history of a key-value pair
7983

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+
8087
### [Portal](#tab/azure-portal)
8188

8289
You can also access the revision history of a specific key-value pair in the portal.
8390

8491
1. In the **Operations** menu, select **Configuration explorer**.
8592
1. Select **More actions** for the key you want to explore, and then **History**
93+
8694
:::image type="content" source="media/explorer-key-history.png" alt-text="Screenshot of the Azure portal selecting key-value history":::
8795

8896
You can now see the revision history for the selected key and information about the changes.
8997

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.
9199

92100
:::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":::
93101

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.
96102

97103
### [Azure CLI](#tab/azure-cli)
98104

@@ -130,7 +136,7 @@ Retrieve the last 10 recorded changes for the key `color` at a specific point-in
130136
az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z"
131137
```
132138

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).
134140

135141
---
136142

0 commit comments

Comments
 (0)