Migrate an API Management instance hosted on the stv1 platform to stv2

Availability

Important

This feature is available in the Premium, Standard, Basic, and Developer tiers of API Management.

Here we help you find guidance to migrate your API Management instance hosted on the stv1 compute platform to the newer stv2 platform. Find out if you need to do this.

There are two different in-place migration scenarios, depending on whether or not your API Management instance is currently deployed (injected) in a VNet. Choose the migration guide for your scenario.

Important

Support for API Management instances hosted on the stv1 platform will be retired by 31 August 2024. If you have instances hosted on the stv1 platform, migrate them to the stv2 platform before that date to avoid service disruptions. Learn more.

In-place migration scenarios

Migrate your instance in-place to the stv2 platform using the Platform migration blade in the portal or the Migrate to stv2 REST API.

Help and support

If you have a support plan and you need technical help, create a support request.

  1. For Summary, type a description of your issue, for example, "stv1 retirement".
  2. Under Issue type, select Technical.
  3. Under Subscription, select your subscription.
  4. Under Service, select My services, then select API Management Service.
  5. Under Resource, select the Azure resource that you’re creating a support request for.
  6. For Problem type, select Administration and Management.
  7. For Problem subtype, select Upgrade, Scale or SKU Changes.