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 los datos con App Configuration. Si desea configurar una sincronización continua con su repositorio de GitHub, eche un vistazo a Acciones de GitHub y tareas de Azure Pipelines.

Puede importar o exportar datos mediante Azure Portal o la CLI 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.

Nota:

No se admite la importación de marcas de características desde un archivo. Si un archivo de configuración contiene marcas de características, se importarán como valores de clave normales automáticamente.

Portal

En Azure Portal, haga lo siguiente:

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

   

2. En la pestaña Importar, seleccione Archivo de configuraciónen Servicio de origen.

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

   Parámetro	Descripción	Ejemplo
   Para el idioma	Elija el idioma del archivo que va a importar entre .NET, Java (Spring) y Otros.	.NET
   Tipo de archivo	Seleccione el tipo de archivo que va a importar entre Yaml, Propiedades y Json.	Json

4. Seleccione el icono Carpeta y busque el archivo para importar.

   Nota

   Se muestra un mensaje en pantalla, lo que indica que el archivo se ha capturado correctamente.

5. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Separador	El separador es el carácter analizado en el archivo de configuración importado para separar los valores de clave que se agregarán al almacén de configuración. Seleccione una de las siguientes opciones: , , , , , , , , /, -, _, —.	;
   Prefijo	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. El prefijo especificado se anexará al inicio de la propiedad "key" de cada par clave-valor que importe desde este archivo.	TestApp:
   Etiqueta	Opcional. Seleccione una etiqueta existente o escriba una nueva etiqueta que se asignará a los valores de clave importados.	prod
   Tipo de contenido	Opcional. Indique si va a importar un archivo JSON o Key Vault referencias. Para obtener más información sobre las referencias de Key Vault, vaya a Usar referencias de Key Vault en una aplicación de ASP.NET Core.	JSON (application/json)

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

Ha importado los pares clave-valor de un archivo JSON y les ha asignado la etiqueta "prod" y el prefijo "TestApp". Se usa el separador ":" y todos los pares clave-valor que ha importado tienen el tipo de contenido establecido como "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 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. En la pestaña Importar, seleccione App Configurationen Servicio de origen.

3. Seleccione Seleccionar recurso, rellene el formulario con los parámetros siguientes y seleccione Aplicar:

   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

   Nota

   El mensaje "Claves de acceso capturadas correctamente" indica que la conexión con el almacén de App Configuration se realizó correctamente".

4. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   De la etiqueta	Seleccione al menos una etiqueta para importar valores con las etiquetas correspondientes. Seleccionar todo importa los valores clave con cualquier etiqueta y (sin etiqueta) restringe la importación a los valores clave sin etiqueta.	prod
   En un momento específico	Opcional. Rellene para importar los valores de clave desde un momento dado específico. Este es el punto en el tiempo de los pares clave-valor en el almacén de configuración seleccionado. Formato: «AAAA/MM/DDTHH:mm:ss». Este campo tiene como valor predeterminado el punto actual en el tiempo de los pares clave-valor cuando se deja vacío.	07/28/2022 12:00:00 AM
   Invalidar etiquetas clave-valor predeterminadas	Opcional. De forma predeterminada, los elementos importados usan su etiqueta actual. Active la casilla y escriba una etiqueta para invalidar estos valores predeterminados con una etiqueta personalizada.	new
   Invalidación del tipo de contenido de clave-valor predeterminado	Opcional. De forma predeterminada, los elementos importados usan su tipo de contenido actual. Active la casilla y active Referencia de Key Vault o JSON (aplicación/json) en Tipo de contenido 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' y este parámetro no lo actualiza.	JSON (application/json)

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

Ha importado los valores de clave y las marcas de características con la etiqueta "prod" de un almacén de App Configuration el 28 de enero de 2021 a las 12:00 y les ha asignado la etiqueta "new". Todos los valores de clave que ha importado tienen el tipo de contenido establecido como "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. En la pestaña Importar, seleccione App Services en Servicio de origen.

3. Seleccione Seleccionar recurso, rellene el formulario con los parámetros siguientes y seleccione Aplicar:

   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

   Nota:

   Se muestra un mensaje, que indica el número de pares clave-valor que se capturaron correctamente del recurso de App Service de origen.

4. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Prefijo	Opcional. Un prefijo de clave es la parte inicial de la propiedad "key" de un par clave-valor. Los prefijos se pueden usar para administrar grupos de pares clave-valor en un almacén de configuración. Este prefijo se anexa al principio de la propiedad "key" de cada clave-valor importado.	TestApp:
   Etiqueta	Opcional. Seleccione una etiqueta existente o escriba una nueva etiqueta que se asignará a los valores de clave importados.	prod
   Tipo de contenido	Opcional. Indique si el archivo que va a importar es una referencia Key Vault o un archivo JSON. Para obtener más información sobre las referencias de Key Vault, vaya a Usar referencias de Key Vault en una aplicación de ASP.NET Core.	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 les asignó la etiqueta "prod" y el prefijo "TestApp". Todos los valores de clave que ha importado tienen el tipo de contenido establecido como "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 los pasos que se indican a continuación para exportar datos de configuración de un almacén de configuración de aplicaciones a un archivo Json, Yaml o Properties.

Nota:

Actualmente, la exportación de marcas de características desde un almacén de App Configuration a un archivo de configuración solo se admite en la CLI.

Portal

En Azure Portal, haga lo siguiente:

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

   

2. En la pestaña Exportar, seleccione Archivo de configuraciónen Servicio de destino.

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

   Parámetro	Descripción	Ejemplo
   Prefijo	Opcional. Este 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.	TestApp:
   De la etiqueta	Seleccione una etiqueta existente para restringir la exportación a los valores de clave con una etiqueta específica. Si no selecciona una etiqueta, solo se exportarán los valores clave-valores con la etiqueta "No label" por defecto. Vea la nota siguiente.	prod
   En un momento específico	Opcional. Rellene para importar los valores de clave desde un momento dado específico. Este es el punto en el tiempo de los pares clave-valor en el almacén de configuración seleccionado. Formato: «AAAA/MM/DDTHH:mm:ss». Este campo tiene como valor predeterminado el punto actual en el tiempo de los pares clave-valor cuando se deja vacío.	07/28/2022 12:00:00 AM
   Tipo de archivo	Seleccione el tipo de archivo que va a exportar entre Yaml, propiedades o Json.	JSON
   Separador	El separador es el delimitador para acoplar los valores de clave a Json/Yaml. Admite la estructura jerárquica de la configuración y no se aplica a los archivos de propiedad y las marcas de características. Seleccione una de las siguientes opciones: ., ,, :, ;, /, -_, — o (Sin separador).	;

   Importante

   Si no selecciona De la etiqueta, solo se exportarán los pares clave-valor sin etiquetas. Para exportar un valor de clave con una etiqueta, debe seleccionar su etiqueta. Tenga en cuenta que solo puede seleccionar una etiqueta por exportación en el portal, en caso de que quiera exportar los valores de clave con todas las etiquetas especificadas, use la CLI.

4. Seleccione Exportar para finalizar la exportación.

Ha exportado los valores de clave que tienen la etiqueta "prod" de un archivo de configuración, en su estado del 28/07/2021 12:00:00 a. m. y recorta el prefijo "TestApp". Los valores están separados por ";" en el archivo.

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 desea exportar y seleccione Importar/exportar en el menú Operaciones.

   

2. En la pestaña Exportar, seleccione App Configuration en Servicio de destino.

3. Seleccione Seleccionar recurso, rellene el formulario con los parámetros siguientes y seleccione Aplicar:

   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.	my-resource-group
   Recurso	Seleccione el almacén App Configuration que contiene la configuración que desea importar.	my-app-config-store

4. La página muestra ahora el servicio de destino y el identificador de recurso seleccionados. La acción Seleccionar recurso le permite cambiar a otro almacén de App Configuration de origen.

   Nota

   Se muestra un mensaje en pantalla, que indica que los pares clave-valor se han capturado correctamente.

5. Rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   De la etiqueta	Seleccione al menos una etiqueta para exportar valores con las etiquetas correspondientes. Seleccionar todo exportará los pares clave-valor con cualquier etiqueta y (Sin etiqueta) restringirá la exportación a los pares clave-valor sin etiqueta.	prod
   En un momento específico	Opcional. Rellene para importar los valores de clave desde un momento dado específico. Este es el punto en el tiempo de los pares clave-valor en el almacén de configuración seleccionado. Formato: «AAAA/MM/DDTHH:mm:ss». Este campo tiene como valor predeterminado el punto actual en el tiempo de los pares clave-valor cuando se deja vacío.	07/28/2022 12:00:00 AM
   Invalidar etiquetas clave-valor predeterminadas	Opcional. De forma predeterminada, los elementos importados usan su etiqueta actual. Active la casilla y escriba una etiqueta para invalidar estos valores predeterminados con una etiqueta personalizada.	new

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

Ha exportado los valores de clave y las marcas de características que tienen la etiqueta "prod" desde un almacén de App Configuration, en su estado desde el 28/07/2022 12:00:00 a. m. y les asignó la etiqueta "new".

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:

Actualmente 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. En la pestaña Exportar, seleccione App Services en Servicio de destino.

3. Seleccione Seleccionar recurso, rellene el formulario con los parámetros siguientes y seleccione Aplicar:

   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 exportar.	my-resource-group
   Recurso	Seleccione el almacén App Service que contiene la configuración que desea exportar.	my-app-service

4. La página muestra ahora el servicio de destino y el identificador de recurso seleccionados. La acción Seleccionar recurso permite cambiar a otro recurso de App Service de destino.

5. Opcionalmente, rellene la siguiente parte del formulario:

   Parámetro	Descripción	Ejemplo
   Prefijo	Opcional. El prefijo se recortará de la propiedad "key" de cada 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. El prefijo se omitirá para las marcas de características.	TestApp:
   Exportación como referencia	Opcional. Compruebe que exporta los pares clave-valor a App Service como referencias de App Configuration. Más información
   En un momento específico	Opcional. Rellene para exportar los valores de clave desde un momento dado específico. Este es el punto en el tiempo de los pares clave-valor en el almacén de configuración seleccionado. Formato: «AAAA/MM/DDTHH:mm:ss». Este campo tiene como valor predeterminado el punto actual en el tiempo de los pares clave-valor cuando se deja vacío.	07/28/2022 12:00:00 AM
   De la etiqueta	Opcional. Seleccione una etiqueta existente para restringir la exportación a los valores de clave con una etiqueta específica. Si no selecciona una etiqueta, solo se exportarán los valores clave-valores con la etiqueta "No label".	prod

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

Ha exportado los valores de clave que tienen la etiqueta "prod" desde un recurso de App Service, en su estado desde el 28/07/2021 12:00:00 a. m. y ha recortado el prefijo "TestApp". Los pares clave-valor se han exportado con un tipo de contenido en formato JSON.

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 archivo seleccionado debe tener entre 1 y 2097152 bytes: su archivo es demasiado grande. Seleccione un archivo más pequeño.
• 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. Para importar pares clave-valor desde un almacén de App Configuration, debe tener acceso a ese almacén. Si es necesario, habilite el acceso público para el almacén de origen o acceda a él desde un punto de conexión privado aprobado. Si acaba de habilitar el acceso público, espere hasta 5 minutos para que la memoria caché se actualice.

Pasos siguientes

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