| title | description | services | documentationcenter | author | manager | editor | ms.service | ms.workload | ms.tgt_pltfrm | ms.topic | ms.date | ms.author |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
How to migrate Azure API Management across regions |
Learn how to migrate an API Management instance from one region to another. |
api-management |
miaojiang |
erikre |
api-management |
mobile |
na |
article |
08/26/2019 |
apimpm |
To migrate API Management instances from one Azure region to another, you can use the backup and restore feature. You should choose the same API Management pricing tier in the source and target regions.
Note
Backup and restore won't work while migrating between different cloud types. For that, you'll need to export the resource as a template. Then, adapt the exported template for the target Azure region and re-create the resource.
- In the target region, create a new API Management instance with the same pricing tier as the source API Management instance. The new instance should have a different name.
- Backup existing API Management instance to a storage account.
- Restore the backup created in Step 2 to the new API Management instance created in the new region in Step 1.
- If you have a custom domain pointing to the source region API Management instance, update the custom domain CNAME to point to the new API Management instance.
Note
This option will result in downtime during the migration.
- Back up the API Management instance in the source region to a storage account.
- Delete the API Management in the source region.
- Create a new API Management instance in the target region with the same name as the one in the source region.
- Restore the backup created in Step 1 to the new API Management instance in the target region.
- For more information about the backup and restore feature, see how to implement disaster recovery.
- For information on migration Azure resources, see Azure cross-region migration guidance.