Importación o exportación de datos de configuración

Azure App Configuration admite las operaciones de importación y exportación. Use estas operaciones para trabajar con datos de configuración de forma masiva e intercambiar datos entre el almacén de App Configuration y el proyecto de código. Por ejemplo, puede configurar un almacén de App Configuration para pruebas y otro para producción. Puede copiar la configuración de la aplicación de uno a otro para no tener que escribir los datos dos veces.

En este artículo se proporciona una guía para importar y exportar datos desde Azure Portal o la CLI de Azure. Si ha adoptado Configuración como código y administra las configuraciones en GitHub o Azure DevOps, puede configurar la importación de archivos de configuración en curso mediante Acciones de GitHub o usar la Tarea de importación de canalización de Azure.

Importar datos

La importación trae los datos de configuración de un almacén de App Configuration desde un origen existente. Use la función de importación para migrar los datos a un almacén de App Configuration o para agregar datos de varios orígenes.

En esta guía se muestra cómo importar datos de App Configuration:

• desde un archivo de configuración en Json, Yaml o Properties
• de un almacén de App Configuration
• de Azure App Service

Importar datos de un archivo de configuración

Siga los pasos que se indican a continuación para importar los pares clave-valor de un archivo.

Portal

En Azure Portal, haga lo siguiente:

1. Vaya a su almacén de App Configuration y seleccione Importar/exportar del menú Operaciones.

   

2. El botón de radio Importar está seleccionado de forma predeterminada. En Tipo de origen, seleccione Archivo de configuración.

3. Rellene el formulario con los siguientes parámetros:

   Parámetro	Descripción	Ejemplo
   Tipo de archivo	Seleccione el tipo de archivo para importar: YAML, Propiedades o JSON.	Json

4. Haga clic en el botón Examinar y seleccione el archivo que quiera importar.

5. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Perfil de contenido del archivo	Seleccione un perfil de contenido: predeterminado o KVSet. El perfil de contenido del archivo predeterminado hace referencia al esquema de archivos de configuración convencional ampliamente adoptado por los sistemas o marcos de programación existentes, y admite formatos de archivo JSON, Yaml o de propiedades. El perfil de contenido del archivo KVSet se refiere a un esquema de archivo que contiene todas las propiedades de un valor clave de App Configuration, incluida la clave, el valor, la etiqueta, el tipo de contenido y las etiquetas.	Valor predeterminado
   Modo de importación	El modo de importación se usa para determinar si se omiten los valores de clave idénticos. Con la opción Omitir coincidencia, se omiten los valores de clave del almacén que sean los mismos que los del archivo de configuración. Con la opción Todo, se actualizan todos los valores clave del archivo de configuración.	Omitir coincidencia
   Excluir marca de características	Si están activadas, no se importarán las marcas de características.	Desactivado
   Estricto	Si la casilla está activada, los valores de clave del almacén con el prefijo y la etiqueta especificados que no se incluyan en el archivo de configuración se eliminan cuando el perfil de contenido del archivo esté establecido en Predeterminado. Cuando el perfil de contenido del archivo se establezca en KVSet, se eliminan los valores de clave del almacén que no se incluyan en el archivo de configuración. Si la casilla está desactivada, no se eliminará ningún valor de clave en el almacén.	Desactivado
   Separador	El separador es el delimitador que se usa para aplanar archivos JSON o YAML en clave-valor. Se omitirá para los archivos de propiedades y las marcas de características. Los valores admitidos incluyen valores sin separador, el punto (.), la coma (,), el punto y coma (;), el guion (-), el guion bajo (_), el guión bajo doble (__), la barra (/) y los dos puntos (:).	:
   Depth	Opcional. Profundidad para aplanar archivos JSON o YAML en pares clave-valor. De forma predeterminada, los archivos se aplanan al nivel más profundo si se selecciona un separador. Esta configuración no es aplicable a los archivos de propiedad ni a las marcas de características.
   Agregar prefijo	Opcional. Si se especifica, se agregará un prefijo a los nombres de clave de todos los valores de clave importados.	TestApp:
   Agregar etiqueta	Opcional. Si se especifica, la etiqueta proporcionada se asignará a todos los valores de clave importados.	prod
   Agregar tipo de contenido	Opcional. Si se especifica, el tipo de contenido proporcionado se agregará a todos los valores de clave importados.	JSON (application/json)
   Incorporación de etiquetas	Opcional. Si se especifica, las etiquetas proporcionadas se agregarán a todos los valores de clave importados.	{tag: tag1}

6. Seleccione Aplicar para continuar con la importación.

Ha importado correctamente los valores de clave de un archivo JSON. Los nombres de clave se aplanaron mediante el separador : y el prefijo con TestApp:. Todos los valores de clave importados se etiquetan como prod, con un tipo de contenido de application/json y etiquetados con tag: tag1.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv import import y agregue los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration al que desea importar datos.	my-app-config-store
   --source	Escriba file para indicar que va a importar datos de configuración de aplicaciones desde un archivo.	file
   --path	Escriba la ruta de acceso local al archivo que contiene los datos que desea importar.	C:/Users/john/Downloads/data.json
   --format	Escriba yaml, properties o json para indicar el formato del archivo que va a importar.	json

2. Opcionalmente, agregue también los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --separator	Opcional. El separador es el delimitador para acoplar los valores de clave a Json/Yaml. Es necesario para exportar la estructura jerárquica y se omitirá para los archivos de propiedades y las marcas de características. Seleccione una de las siguientes opciones: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opcional. Un prefijo de clave es la parte inicial de una clave. Los prefijos se pueden usar para administrar grupos de pares clave-valor en un almacén de configuración. Este prefijo se anexará al inicio de la propiedad "key" de cada par clave-valor importado.	TestApp:
   --label	Opcional. Escriba una etiqueta que se asignará a los valores de clave importados.	prod
   --content-type	Opcional. Escriba appconfig/kvset o application/json para indicar que el contenido importado consta de una referencia de Key Vault o un archivo JSON.	application/json

   Ejemplo: importe todos los pares clave-valor y marcas de características de un archivo JSON, aplique la etiqueta "prod" y anexe el prefijo "TestApp". Agregue el tipo de contenido "application/json".

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. La línea de comandos muestra una lista de los próximos cambios. Para confirmar la importación, seleccione y.

   

Ha importado los valores de clave de un archivo JSON y les ha asignado la etiqueta "prod" y el prefijo "TestApp:". El separador ";" se usa y todos los valores de clave que importó tienen el tipo de contenido establecido como "JSON".

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv import.

Importación de datos de un almacén de App Configuration

Puede importar valores de un almacén de App Configuration a otro App Configuration almacén, o puede importar valores de un almacén de App Configuration al mismo almacén de App Configuration para duplicar sus valores y aplicar parámetros diferentes, como una nueva etiqueta o tipo de contenido.

Siga los pasos que se indican a continuación para importar los valores clave y las marcas de características desde un almacén de Azure App Configuration.

Portal

En Azure Portal, haga lo siguiente:

1. Vaya a su almacén de App Configuration y seleccione Importar/exportar del menú Operaciones.

   

2. El botón de radio Importar está seleccionado de forma predeterminada. En Tipo de origen, seleccione App Configuration.

3. Seleccione un almacén de App Configuration para importar datos y rellene el formulario con los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   Suscripción	La suscripción actual está seleccionada de forma predeterminada.	my-subscription
   Resource group	Seleccione un grupo de recursos que contenga el almacén de App Configuration con configuración que se va a importar. Se selecciona el grupo de recursos actual de forma predeterminada.	my-resource-group
   Recurso	Seleccione el almacén App Configuration que contiene la configuración que desea importar.	my-other-app-config-store

4. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Modo de selección	Seleccione si quiere realizar la importación desde valores de clave normales, que es la opción predeterminada o desde una instantánea.	Valor predeterminado
   Filtro de clave	Se usa para filtrar los valores de clave en función del nombre de clave para la importación. Si no se especifica ninguna clave, todas las claves son aptas.	Comienza con la prueba
   En un momento específico	Opcional. Rellene este campo para importar los valores de clave desde un momento dado específico en el almacén de configuración seleccionado. Si se deja vacío, el valor predeterminado es el punto actual en el tiempo de los valores de clave.	07/28/2022 12:00:00 AM
   De la etiqueta	Seleccione una o varias etiquetas para importar los valores de clave asociados a esas etiquetas. Si no se selecciona ninguna etiqueta, todas las etiquetas son aptas.	prod
   Excluir marca de características	Si están activadas, no se importarán las marcas de características.	Desactivado
   Agregar prefijo	Opcional. Si se especifica, se agregará un prefijo a los nombres de clave de todos los valores de clave importados.	TestApp:
   Invalidar etiquetas	Opcional. De forma predeterminada, se conservan las etiquetas originales de los valores clave de origen. Para invalidarlas, active la casilla y escriba una nueva etiqueta para los valores de clave importados.	new
   Invalidar tipos de contenido	Opcional. De forma predeterminada, se conservan los tipos de contenido originales de los valores de clave de origen. Para invalidarlas, active la casilla y escriba un nuevo tipo de contenido para los valores de clave importados. Tenga en cuenta que el tipo de contenido de las marcas de características no se puede invalidar.	JSON (application/json)

5. Seleccione Aplicar para continuar con la importación.

Ha importado los valores de clave de un almacén de App Configuration a partir del 28 de enero de 2021, a las 12:00, con nombres de clave a partir de test y la etiqueta prod. Los nombres de clave se prefijos con TestApp:. A todos los valores de clave importados se les asignó la etiqueta new y el tipo de contenido application/json.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv import import y introduzca los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration al que desea importar datos.	my-app-config-store
   --source	Escriba appconfig para indicar que va a importar datos desde un almacén de App Configuration.	appconfig
   --src-name	Escriba el nombre del almacén de App Configuration desde el que desea importar datos.	my-source-app-config
   --src-label	Restrinja la importación a pares clave-valor con una etiqueta específica. Si no usa este parámetro, solo se importarán los pares clave-valor con una etiqueta null. Admite el signo de estrella como filtro: escriba * para todas las etiquetas; abc* para todas las etiquetas con abc como prefijo.	prod

2. Opcionalmente, agregue los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --label	Opcional. Escriba una etiqueta que se asignará a los valores de clave importados.	new
   --content-type	Opcional. Escriba appconfig/kvset o application/json para indicar que el contenido importado consta de una referencia de Key Vault o un archivo JSON. El tipo de contenido solo se puede invalidar para los valores de clave importados. El tipo de contenido predeterminado para las marcas de características es "application/vnd.microsoft.appconfig.ff+json;charset=utf-8' de manera predeterminada y este parámetro no lo actualiza.	application/json

   Ejemplo: importe pares clave-valor y marcas de características con la etiqueta "prod" de otro almacén de App Configuration y asígneles la etiqueta "new". Agregue el tipo de contenido "application/json".

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. La línea de comandos muestra una lista de los próximos cambios. Para confirmar la importación, seleccione y.

   

Ha importado los valores de clave con la etiqueta "prod" de un almacén de App Configuration y les ha asignado la etiqueta "new". Todos los valores de clave que ha importado tienen el tipo de contenido establecido como "JSON".

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv import.

Importación de datos de Azure App Service

Siga los pasos que se indican a continuación para importar los pares clave-valor de Azure App Service.

Nota

App Service no admite actualmente marcas de características. Todas las marcas de características importadas a App Service se convierten automáticamente en valores de clave. Los recursos de App Service solo pueden contener valores de clave.

Portal

En el Portal de Azure:

1. Vaya a su almacén de App Configuration y seleccione Importar/exportar del menú Operaciones.

   

2. El botón de radio Importar está seleccionado de forma predeterminada. En Tipo de origen, seleccione App Services.

3. Seleccione un almacén de App Configuration para importar datos y rellene el formulario con los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   Suscripción	La suscripción actual está seleccionada de forma predeterminada.	my-subscription
   Resource group	Seleccione un grupo de recursos que contenga el almacén de App Service con configuración que se va a importar.	my-resource-group
   Recurso	Seleccione el almacén App Service que contiene la configuración que desea importar.	my-app-service

4. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Actualización de la configuración a la que se hace referencia	Si está activada, la configuración de la aplicación en App Service se actualizará a las referencias de App Configuration para los valores de clave importados. Esto le permite administrar la configuración de la aplicación en App Configuration en el futuro. App Service extraerá automáticamente el valor actual de App Configuration. Para más información, consulte Uso de referencias de App Configuration para App Service y Azure Functions.	Activada
   Agregar prefijo	Opcional. Si se especifica, se agregará un prefijo a los nombres de clave de todos los valores de clave importados.	TestApp:
   Agregar etiqueta	Opcional. Si se especifica, la etiqueta proporcionada se asignará a todos los valores de clave importados.	prod
   Agregar tipo de contenido	Opcional. Si se especifica, el tipo de contenido proporcionado se agregará a todos los valores de clave importados.	JSON (application/json)

5. Seleccione Aplicar para continuar con la importación.

Ha importado toda la configuración de la aplicación de una instancia de App Service como clave-valores y le ha asignado la etiqueta prod y el prefijo TestApp:. Todos los valores de clave que ha importado tienen el tipo de contenido establecido como application/json.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv import import y agregue los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration al que desea importar datos.	my-app-config-store
   --source	Escriba appservice para indicar que va a importar datos de configuración de aplicaciones desde App Service.	appservice
   --appservice-account	Introduzca el identificador de ARM para AppService o use el nombre de AppService si se encuentra en la misma suscripción y grupo de recursos que la App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service o my-app-service

2. Opcionalmente, agregue también los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --prefix	Opcional. Un prefijo de clave es la parte inicial de propiedad de clave-valor "key". Los prefijos se pueden usar para administrar grupos de pares clave-valor en un almacén de configuración. Este prefijo se anexará al inicio de la propiedad "key" de cada par clave-valor importado.	TestApp:
   --label	Opcional. Escriba una etiqueta que se asignará a los valores de clave importados. Si no especifica una etiqueta, la etiqueta null se asignará a los valores de clave.	prod
   --content-type	Opcional. Escriba appconfig/kvset o application/json para indicar que el contenido importado consta de una referencia de Key Vault o un archivo JSON.	application/json

   Para obtener el valor de --appservice-account, use el comando az webapp show --resource-group <resource-group> --name <resource-name>.

   Ejemplo: importe toda la configuración de la aplicación desde el App Service como clave-valores con la etiqueta "prod", al almacén de App Configuration y agregue un prefijo "TestApp:".

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. La línea de comandos muestra una lista de los próximos cambios. Para confirmar la importación, seleccione y.

   

Ha importado toda la configuración de la aplicación de App Service como clave-valores, les asignó la etiqueta "prod" y agregó un prefijo "TestApp:". Todos los pares clave-valor que ha importado tienen el tipo de contenido establecido como "JSON".

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv import.

Exportar datos

La exportación escribe los datos de configuración almacenados en App Configuration a otro destino. Utilice la función de exportación, por ejemplo, para guardar los datos de un almacén de App Configuration en un archivo que puede insertarse en el código de aplicación durante la implementación.

En esta guía se muestra cómo exportar datos de App Configuration:

• a un archivo de configuración en Json, Yaml o Properties
• a un almacén de App Configuration
• a un recurso de Azure App Service

Exportación de datos a un archivo de configuración

Siga estos pasos para exportar datos de configuración desde un almacén de App Configuration a un archivo JSON, YAML o de propiedades.

Portal

En Azure Portal, haga lo siguiente:

1. Vaya a su almacén de App Configuration y seleccione Importar/Exportar.

   

2. Seleccione el botón de radio Exportar y, en Tipo de destino, seleccione Archivo de configuración.

3. Rellene el formulario con los siguientes parámetros:

   Parámetro	Descripción	Ejemplo
   Tipo de archivo	Seleccione el tipo de archivo para exportar: YAML, de propiedades o JSON.	JSON
   Perfil de contenido del archivo	Seleccione un perfil de contenido: predeterminado o KVSet. El perfil de contenido del archivo predeterminado hace referencia al esquema de archivos de configuración convencional ampliamente adoptado por los sistemas o marcos de programación existentes, y admite formatos de archivo JSON, Yaml o de propiedades. El perfil de contenido del archivo KVSet se refiere a un esquema de archivo que contiene todas las propiedades de un valor clave de App Configuration, incluida la clave, el valor, la etiqueta, el tipo de contenido y las etiquetas.	Valor predeterminado
   Modo de selección	Seleccione si desea exportar desde valores clave regulares, que es la opción predeterminada, o desde una instantánea.	Valor predeterminado
   Filtro de clave	Se usa para filtrar los valores de clave en función del nombre de clave para la exportación. Si no se especifica ninguna clave, todas las claves son aptas.	Comienza con TestApp:
   En un momento específico	Opcional. Rellene este campo para exportar los valores de clave desde un momento dado específico en el almacén de configuración seleccionado. Si se deja vacío, el valor predeterminado es el punto actual en el tiempo de los valores de clave.	07/28/2022 12:00:00 AM
   De la etiqueta	Seleccione la etiqueta para exportar los valores de clave asociados a esas etiquetas. Si no se selecciona ninguna etiqueta, todas las etiquetas son aptas. Tenga en cuenta que solo puede seleccionar una etiqueta al exportar con el perfil de contenido del archivo Default. Para exportar los valores de clave con más de una etiqueta, use el perfil de contenido del archivo KVSet.	prod
   Quitar el prefijo	Opcional. Si se especifica, el prefijo se quitará de los nombres de clave de todos los valores de clave exportados que lo contengan.	TestApp:
   Separador	El separador es el delimitador que se usa para segmentar nombres de clave y reconstruir configuraciones jerárquicas para archivos JSON o YAML a partir de valores de clave. Se omitirá para los archivos de propiedades y las marcas de características. Los valores admitidos incluyen valores sin separador, el punto (.), la coma (,), el punto y coma (;), el guion (-), el guion bajo (_), el guión bajo doble (__), la barra (/) y los dos puntos (:).	:

4. Seleccione Exportar para finalizar la exportación.

Ha exportado los valores de clave de un almacén de App Configuration a partir del 28 de julio de 2021, a las 12:00, con nombres de clave a partir de TestApp: y la etiqueta prod a un archivo JSON. El prefijo TestApp: se ha recortado de los nombres de clave y el separador : se ha usado para segmentar los nombres de clave y reconstruir el formato JSON jerárquico.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv export export y agregue los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration que contiene los valores de clave que desea exportar.	my-app-config-store
   --destination	Escriba file para indicar que va a exportar datos a un archivo.	file
   --path	Introduzca la ruta de acceso donde quiere guardar el archivo.	C:/Users/john/Downloads/data.json
   --format	Escriba yaml, properties o json para indicar el formato del archivo que desea exportar.	json
   --label	Escriba una etiqueta para exportar pares clave-valor y marcas de características con esta etiqueta. Si no especifica una etiqueta, de manera predeterminada, solo exporta los valores clave y las marcas de características sin etiqueta. Puede escribir una etiqueta, escribir varias etiquetas separándolas con ,, o use * para tener en cuenta todas las etiquetas.	prod

   Importante

   Si no selecciona una etiqueta, solo se exportarán los pares clave-valor sin una etiqueta. Para exportar un valor de clave con una etiqueta, debe seleccionar su etiqueta.

2. Opcionalmente, agregue también los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --separator	Opcional. El separador es el delimitador para acoplar los valores de clave a Json/Yaml. Es necesario para exportar la estructura jerárquica y se omitirá para los archivos de propiedades y las marcas de características. Seleccione una de las siguientes opciones: ., ,, :, ;, /, -, _, —.	;
   --prefix	Opcional. El prefijo se recortará de la propiedad "key" de cada par clave-valor. Un prefijo de clave es la parte inicial de una clave. Los prefijos se pueden usar para administrar grupos de pares clave-valor en un almacén de configuración. El prefijo se omitirá para las marcas de características.	TestApp:

   Ejemplo: exporte todas los pares clave-valor y las marcas de características con la etiqueta "prod" a un archivo JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. La línea de comandos muestra una lista de valores de clave que se exportan al archivo. Para confirmar la exportación, seleccione y.

   

Ha exportado los valores de clave y las marcas de características que tienen la etiqueta "prod" en un archivo de configuración y han recortado el prefijo "TestApp". Los valores están separados por ";" en el archivo.

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv export.

Exportación de datos a un almacén de App Configuration

Siga los pasos que se indican a continuación para exportar los valores clave y las marcas de características a un almacén de Azure App Configuration.

Puede exportar valores de un almacén de App Configuration a otro App Configuration almacén, o puede exportar valores de un almacén de App Configuration al mismo almacén de App Configuration para duplicar sus valores y aplicar parámetros diferentes, como una nueva etiqueta o tipo de contenido.

Portal

En Azure Portal, haga lo siguiente:

1. Vaya al almacén de App Configuration que contiene los datos que quiera exportar y seleccione Importar/exportar en el menú Operaciones.

   

2. Seleccione el botón de radio Exportar y, en Tipo de destino, seleccione App Configuration.

3. Rellene el formulario con los siguientes parámetros:

   Parámetro	Descripción	Ejemplo
   Modo de selección	Seleccione si desea exportar desde valores clave regulares, que es la opción predeterminada, o desde una instantánea.	Valor predeterminado
   Filtro de clave	Se usa para filtrar los valores de clave en función del nombre de clave para la exportación. Si no se especifica ninguna clave, todas las claves son aptas.	Comienza con TestApp:
   En un momento específico	Opcional. Rellene este campo para exportar los valores de clave desde un momento dado específico en el almacén de configuración seleccionado. Si se deja vacío, el valor predeterminado es el punto actual en el tiempo de los valores de clave.	07/28/2022 12:00:00 AM
   De la etiqueta	Seleccione una o varias etiquetas para exportar los valores de clave asociados a esas etiquetas. Si no se selecciona ninguna etiqueta, todas las etiquetas son aptas.	prod
   Excluir marca de características	Si están activadas, no se exportarán las marcas de características.	Desactivado

4. Seleccione almacén de destino y rellene el formulario con los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   Suscripción	La suscripción actual está seleccionada de forma predeterminada.	my-subscription
   Resource group	Seleccione un grupo de recursos que contenga el almacén de App Configuration donde desea exportar la configuración. Se selecciona el grupo de recursos actual de forma predeterminada.	my-resource-group
   Resource	Seleccione el almacén de App Configuration donde quiera exportar la configuración.	my-other-app-config-store

5. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Quitar el prefijo	Opcional. Si se especifica, el prefijo se quitará de los nombres de clave de todos los valores de clave exportados que lo contengan.	TestApp:
   Invalidar etiquetas	Opcional. De forma predeterminada, se conservan las etiquetas originales de los valores clave de origen. Para invalidarlos, active la casilla y escriba una nueva etiqueta para los valores de clave exportados.	new
   Invalidar tipos de contenido	Opcional. De forma predeterminada, se conservan los tipos de contenido originales de los valores de clave de origen. Para invalidarlas, active la casilla y escriba un nuevo tipo de contenido para los valores de clave exportados. Tenga en cuenta que el tipo de contenido de las marcas de características no se puede invalidar.	JSON (application/json)

6. Seleccione Aplicar para continuar con la exportación.

Exportó los valores de clave desde un almacén de App Configuration a partir del 28 de julio de 2022, a las 12:00, con nombres de clave a partir de TestApp: y la etiqueta prod, a otro almacén de App Configuration. Todos los valores de clave exportados se recortaron el prefijo de clave TestApp: y asignaron la etiqueta new y el tipo de contenido application/json.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv export export y introduzca los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration que contiene los valores de clave que desea exportar.	my-app-config-store
   --destination	Escriba appconfig para indicar que va a exportar datos a un almacén de App Configuration.	appconfig
   --dest-name	Escriba el nombre del almacén de App Configuration al que desea exportar datos.	my-other-app-config-store
   --label	Escriba una etiqueta para exportar pares clave-valor y marcas de características con esta etiqueta. Si no especifica una etiqueta, de manera predeterminada, solo exportará los pares clave-valor y las marcas de características sin etiqueta. Puede escribir una etiqueta, escriba varias etiquetas separándolas con , o use * para tomar todas las etiquetas de la cuenta.	prod

   Importante

   Si los pares clave-valor que quiere exportar tienen etiquetas, debe usar el comando --label y escribir las etiquetas correspondientes. Si no selecciona una etiqueta, solo se exportarán los pares clave-valor sin una etiqueta. Use un signo de coma (,) para seleccionar varias etiquetas o usar * para incluir todas las etiquetas, incluida la etiqueta null (sin etiqueta).

2. Opcionalmente, agregue también el parámetro siguiente:

   Parámetro	Descripción	Ejemplo
   --dest-label	Opcional. Escriba una etiqueta de destino para asignar esta etiqueta a los valores de clave exportados.	new

   Ejemplo: exporte pares clave-valor y marcas de características con la etiqueta "prod" a otro almacén de App Configuration y agregue la etiqueta de destino "new".

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. La línea de comandos muestra una lista de valores de clave que se exportan los archivos. Para confirmar la exportación, seleccione y.

   

Exportó los valores de clave y las marcas de características que tienen la etiqueta "prod" desde un almacén de App Configuration y les ha asignado la etiqueta "new".

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv import.

Exportación de datos a Azure App Service

Siga los pasos que se indican a continuación para exportar a los pares clave-valor de Azure App Service.

Nota:

No se admite la exportación de marcas de características a App Service.

Portal

En Azure Portal, haga lo siguiente:

1. Vaya a su almacén de App Configuration y seleccione Importar/exportar del menú Operaciones.

   

2. Seleccione el botón de radio Exportar y, en Tipo de destino, seleccione App Services.

3. La opción Exportar como referencia está activada de forma predeterminada. Cuando se activa la casilla, la configuración de la aplicación en App Service se agregará como referencias de App Configuration para los valores de clave exportados. Esto le permite administrar la configuración en App Configuration, con la instancia de App Service que extrae automáticamente los valores actuales de App Configuration. Para más información, consulte Uso de referencias de App Configuration para App Service y Azure Functions. Si la casilla está desactivada, la clave y el valor se exportarán directamente a App Service. Recuerde volver a exportar los datos cada vez que realice cambios en App Configuration para asegurarse de que la aplicación recoja las actualizaciones.

4. Rellene el formulario con los siguientes parámetros:

   Parámetro	Descripción	Ejemplo
   Modo de selección	Seleccione si desea exportar desde valores clave regulares, que es la opción predeterminada, o desde una instantánea.	Valor predeterminado
   Filtro de clave	Se usa para filtrar los valores de clave en función del nombre de clave para la exportación. Si no se especifica ninguna clave, todas las claves son aptas.	Comienza con TestApp:
   En un momento específico	Opcional. Rellene este campo para exportar los valores de clave desde un momento dado específico en el almacén de configuración seleccionado. Si se deja vacío, el valor predeterminado es el punto actual en el tiempo de los valores de clave.	07/28/2022 12:00:00 AM
   De la etiqueta	Seleccione una etiqueta para exportar los valores de clave asociados a esa etiqueta.	prod

5. Seleccione un almacén de destino y rellene el formulario con los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   Suscripción	La suscripción actual está seleccionada de forma predeterminada.	my-subscription
   Resource group	Seleccione un grupo de recursos que contenga App Service donde quiera exportar la configuración.	my-resource-group
   Resource	Seleccione la instancia de App Service en la que quiera exportar la configuración.	my-app-service

6. Opcionalmente, rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Quitar el prefijo	Opcional. Si se especifica, el prefijo se quitará de los nombres de clave de todos los valores de clave exportados que lo contengan.	TestApp:

7. Seleccione Aplicar para continuar con la exportación.

Exportó los valores de clave desde un almacén de App Configuration a partir del 28 de julio de 2022, a las 12:00, con nombres de clave a partir de TestApp: y la etiqueta prod, a la configuración de la aplicación de un recurso de App Service. El prefijo TestApp: se ha recortado de los nombres de clave exportados.

Si activa la casilla para exportar los valores de clave como referencias, los valores de clave exportados se indican como referencias de App Configuration en la columna "Origen" de los valores de configuración de recursos de App Service.

CLI de Azure

Desde el CLI de Azure, sigua los pasos siguientes. Si no tiene la CLI de Azure instalada localmente, también puede usar Azure Cloud Shell.

1. Escriba el comando az appconfig kv export export y introduzca los parámetros siguientes:

   Parámetro	Descripción	Ejemplo
   --name	Escriba el nombre del almacén de App Configuration que contiene los valores de clave que desea exportar.	my-app-config-store
   --destination	Escriba appservice para indicar que va a exportar datos a App Service.	appservice
   --appservice-account	Introduzca el identificador de ARM para AppService o use el nombre de AppService si se encuentra en la misma suscripción y grupo de recursos que la App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service o my-app-service
   --label	Opcional. Escriba una etiqueta para exportar pares clave-valor y marcas de características con esta etiqueta. Si no especifica una etiqueta, de manera predeterminada, solo exportará los valores clave y las marcas de características sin etiqueta.	prod

   Para obtener el valor de --appservice-account, use el comando az webapp show --resource-group <resource-group> --name <resource-name>.

2. También puede agregar un prefijo:

   Parámetro	Descripción	Ejemplo
   --prefix	Opcional. El prefijo se recortará de la propiedad "key" de un par clave-valor exportado. Un prefijo de clave es la parte inicial de una clave. Los prefijos se pueden usar para administrar grupos de pares clave-valor en un almacén de configuración.	TestApp:

   Ejemplo: exporte todos los valores de clave con la etiqueta "prod" a una aplicación de App Service y recorte el prefijo "TestApp".

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   La línea de comandos muestra una lista de pares clave-valor que se exportan a un recurso de App Service. Para confirmar la exportación, seleccione y.

   

   Ha exportado todos los valores de clave con la etiqueta "prod" a un recurso de Azure App Service y ha recortado el prefijo "TestApp:".

3. Opcionalmente, especifique una marca para exportar como referencia de App Configuration.

   Parámetro	Descripción
   --export-as-reference -r	Opcional. Especifique si los pares clave-valor se exportan a App Service como referencias de App Configuration. Más información.

   Ejemplo: exporte todos los pares clave-valor con la etiqueta "prod" como referencias de App Configuration a una aplicación de App Service.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   La línea de comandos muestra una lista de los pares clave-valor que se exportan como referencias de App Configuration a un recurso de App Service. Para confirmar la exportación, seleccione y.

   

   Ha exportado todos los pares clave-valor con la etiqueta "prod" como referencias de configuración de la aplicación a un recurso de Azure App Service. En el recurso de App Service, los pares clave-valor importados se indicarán como referencias de App Configuration en la columna "Origen".

   

Para obtener más parámetros opcionales y ejemplos, vaya a az appconfig kv export.

Mensajes de error

Es posible que encuentre los mensajes de error siguientes al importar o exportar pares clave-valor de App Configuration:

• El acceso público está deshabilitado para el almacén o está accediendo desde un punto de conexión privado que no está en las configuraciones de punto de conexión privado del almacén. Si el almacén de App Configuration tiene habilitados puntos de conexión privados, solo puede acceder a él desde la red virtual configurada de forma predeterminada. Asegúrese de que la máquina que ejecuta Azure Portal o la CLI esté unida a la misma red virtual que el punto de conexión privado. Si acaba de habilitar el acceso de red pública al almacén de App Configuration, espere al menos 5 minutos antes de volver a intentarlo para permitir que la memoria caché se actualice.

Pasos siguientes

Integración con una canalización de CI/CD