Pares clave-valor en un momento dado

Azure App Configuration mantiene un registro de los cambios realizados en los valores clave. Este registro proporciona una escala de tiempo de los cambios de clave-valor. Puede reconstruir el historial de cualquier clave y proporcionar su valor pasado en cualquier momento dentro del período de historial de claves (7 días para almacenes de nivel Gratis o 30 días para almacenes de nivel Estándar). Con esta característica, puede "viajar en el tiempo" hacia atrás y recuperar un valor de clave antiguo. Por ejemplo, puede recuperar las opciones de configuración usadas antes de la implementación más reciente para revertir la aplicación a la configuración anterior.

Restaurar valores clave

Puede usar Azure Portal o la CLI de Azure para recuperar valores de clave anteriores.

Portal

1. Inicie sesión en Azure Portal. Seleccione Todos los recursos y seleccione la instancia del almacén de App Configuration donde se almacenan los valores de clave.

2. En el menú Operaciones , seleccione Restaurar.

   

3. Seleccione Fecha: seleccione fecha para seleccionar una fecha y hora a la que desea revertir.

4. Haga clic fuera de los campos de fecha y hora o presione Tab para validar su elección. Ahora puede ver qué valores de clave han cambiado entre la fecha y hora seleccionadas y la hora actual. Este paso le ayuda a comprender a qué claves y valores está preparando la reversión.

   

   El portal muestra una tabla de valores de clave. La primera columna incluye símbolos que indican lo que ocurrirá si restaura los datos de la fecha y hora elegidas:

   • El signo menos rojo (–) significa que el valor de clave no existía en la fecha y hora seleccionadas y se eliminará.
   • El signo más verde (+) significa que el valor de clave existía en la fecha y hora seleccionadas y no existe ahora. Si vuelve a la fecha y hora seleccionadas, se volverá a agregar a la configuración.
   • El signo de viñeta en naranja (•) significa que el valor de clave se modificó desde la fecha y hora seleccionadas. La clave revertirá al valor que tenía en la fecha y hora seleccionadas.

5. Marque la casilla en la fila para seleccionar o deseleccionar el valor de la clave y tomar acción. Cuando se selecciona, se mostrará la diferencia del valor de clave entre la fecha y hora actual y la fecha y hora seleccionada.

   

   En el ejemplo anterior, la vista previa muestra la clave TestApp:Settings:BackgroundColor, que actualmente tiene un valor de #FFF. Este valor se modificará a #45288E si realizamos la restauración de los datos.

   Puede seleccionar una o varias casillas en la tabla para realizar acciones en el valor clave de su elección. También puede usar la casilla Seleccionar todo en la parte superior de la lista para seleccionar o anular la selección de todos los valores de clave.

6. Seleccione Restaurar para restaurar los valores de clave seleccionados a los datos y la hora seleccionados.

   

CLI de Azure

Use la CLI de Azure como se explica a continuación para recuperar y restaurar los valores de clave anteriores. Si no tiene instalada la CLI de Azure localmente, también puede usar Azure Cloud Shell.

En la CLI, use az appconfig revision list para ver los cambios o az appconfig kv restore para restaurar los valores de clave, agregando parámetros adecuados. Especifique la instancia de Azure App Configuration proporcionando el nombre del almacén (--name <app-config-store-name>) o mediante una cadena de conexión (--connection-string <your-connection-string>). Restrinja la salida especificando un momento dado específico (--datetime), una etiqueta (--label) y el número máximo de elementos que se van a devolver (--top). y especificando el número máximo de elementos que se van a devolver (--top).

Recupere todos los cambios registrados en los pares clave-valor.

az appconfig revision list --name <your-app-config-store-name>

Restaure todos los valores de clave a un momento dado

az appconfig kv restore --name <app-config-store-name> --datetime "2019-05-01T11:24:12Z"

Restaure para cualquier etiqueta que empiece por v1. a un momento dado.

az appconfig kv restore --name <app-config-store-name> --label v1.* --datetime "2019-05-01T11:24:12Z"

Para obtener más ejemplos de comandos de la CLI y parámetros opcionales para restaurar key-value, vaya a la documentación de la CLI de Azure.

También puede acceder al historial de un valor de clave específico. Esta característica permite comprobar el valor de una clave específica en un momento dado elegido y revertir a un valor pasado sin actualizar ningún otro valor de clave.

Vista histórica o de escala de tiempo de valor de clave

Sugerencia

Este método es cómodo si no tiene más de un par de cambios para realizar, ya que el Explorador de configuración solo le permite realizar cambios clave por clave. Si necesita restaurar varios valores de clave a la vez, use el menú Restaurar en su lugar.

Portal

También puede acceder al historial de revisiones de un valor de clave específico en el portal.

1. En el menú Operaciones , seleccione Explorador de configuración.

2. Seleccione Más acciones para la clave que desea explorar y, a continuación, Historial.

   

   Ahora puede ver el historial de revisiones de la clave seleccionada e información sobre los cambios.

3. Seleccione Restaurar para restaurar la clave y el valor a este momento dado.

   

CLI de Azure

Use la CLI de Azure como se explica a continuación para recuperar y restaurar un único valor de clave. Si no tiene instalada la CLI de Azure localmente, también puede usar Azure Cloud Shell.

En la CLI, use az appconfig revision list para ver los cambios en un valor de clave o usar az appconfig kv restore para restaurar un valor de clave, agregando parámetros adecuados. Especifique la instancia de Azure App Configuration proporcionando el nombre del almacén (--name <app-config-store-name>) o mediante una cadena de conexión (--connection-string <your-connection-string>). Restrinja la salida especificando una clave específica (--key). Opcionalmente, especifique una etiqueta (--label), un momento dado (--datetime) y el número máximo de elementos que se van a devolver (--top).

Enumere el historial de revisiones de la clave "color" con todas las etiquetas.

az appconfig revision list --name <app-config-store-name> --key color

Enumerar el historial de revisiones de un valor de clave específico con una etiqueta.

az appconfig revision list --name <app-config-store-name> --key color --label test

Enumerar el historial de revisiones de un valor de clave con varias etiquetas.

az appconfig revision list --name <app-config-store-name> --key color --label test,prod,\0

Recupere todos los cambios registrados para la clave color en un momento dado específico.

az appconfig revision list --name <app-config-store-name> --key color --datetime "2019-05-01T11:24:12Z" 

Recupere los últimos 10 cambios registrados para la clave color en un momento dado específico.

az appconfig revision list --name <app-config-store-name> --key color --top 10 --datetime "2019-05-01T11:24:12Z" 

Para obtener más ejemplos y parámetros opcionales, vaya a la documentación de la CLI de Azure.

Paso siguiente

Creación de una aplicación web de ASP.NET Core