Move an App Configuration store to another region

App Configuration stores are region-specific and can't be moved across regions automatically. You must create a new App Configuration store in the target region, then move your content from the source store to the new target store. You might move your configuration to another region for a number of reasons. For example, to take advantage of a new Azure region with Availability Zone support, to deploy features or services available in specific regions only, or to meet internal policy and governance requirements.

The following steps walk you through the process of creating a new target store and exporting your current store to the new region.

Design considerations

Before you begin, keep in mind the following concepts:

  • Configuration store names are globally unique.
  • You need to reconfigure your access policies and network configuration settings in the new configuration store.

Create the target configuration store

To create a new App Configuration store in the Portal, follow these steps:

  1. Sign in to the Azure portal. In the upper-left corner of the home page, select Create a resource. In the Search the Marketplace box, enter App Configuration and select Enter.

    Search for App Configuration

  2. Select App Configuration from the search results, and then select Create.

    Select Create

  3. On the Create App Configuration pane, enter the following settings:

    Setting Suggested value Description
    Subscription Your subscription Select the Azure subscription of your original store
    Resource group Your resource group Select the Azure resource group of your original store
    Resource name Globally unique name Enter a unique resource name to use for the target App Configuration store. This can not be the same name as the previous configuration store.
    Location Your target Location Select the target region you want to move your configuration store to.
    Pricing tier Standard Select the desired pricing tier. For more information, see the App Configuration pricing page.
  4. Select Review + create to validate your settings.

  5. Select Create. The deployment might take a few minutes.

  6. Once the resource has been deployed, recreate the access policies and network configuration settings of our source store. These will not be transferred with the configuration. This can include using manage identities, virtual networks, and public network access.

Transfer your configuration key-values

Follow these steps to export your configuration to the target store using the Portal:

  1. Navigate to your source configuration store in the Azure portal and select Import/Export under Operations .
  2. Select Export and choose App Configuration in the Target Service dropdown. Export to another configuration store
  3. Click on Select Resource and enter your Subscription and Resource group. The Resource is the name of the target configuration store you created previously.
  4. Select Apply to verify your target configuration store.
  5. Leave the from label, time, and Label fields as their default values and select Apply.
  6. To verify that your configurations have been successfully transferred from your source to your target store, navigate to your target configuration store in the portal. Select Configuration Explorer under Operations and verify that this contains the same key value pairs as those in your original store.

    Note

    This process only allows for configuration key-values to be exported by one label at a time. To export multiple, repeat steps 2-5 for each label.

Delete your source configuration store

If the configuration has been transferred to the target store, you can choose to delete your source configuration store.

Follow these steps to delete your source configuration store in the Portal:

  1. Sign in to the Azure portal, and select Resource groups.
  2. In the Filter by name box, enter the name of your resource group.
  3. In the result list, select the resource group name to see an overview.
  4. Select your source configuration store, and on the Overview blade, select Delete.
  5. You're asked to confirm the deletion of the configuration store, select Yes.

After a few moments, the source configuration store will have been deleted.

Next steps