API Management stv1 platform retirement (August 2024)
Availability
Important
This feature is available in the Premium, Standard, Basic, and Developer tiers of API Management.
As a cloud platform-as-a-service (PaaS), Azure API Management abstracts many details of the infrastructure used to host and run your service. The infrastructure associated with the API Management stv1
compute platform version will be retired effective 31 August 2024. A more current compute platform version (stv2
) is already available, and provides enhanced service capabilities.
Note
For API Management instances deployed in Azure operated by 21Vianet cloud (Azure in China), the retirement date for the stv1
platform is 24 February 2025. Learn more
The following table summarizes the compute platforms currently used for instances in the different API Management service tiers.
Version | Description | Architecture | Tiers |
---|---|---|---|
stv2 |
Single-tenant v2 | Azure-allocated compute infrastructure that supports availability zones, private endpoints | Developer, Basic, Standard, Premium |
stv1 |
Single-tenant v1 | Azure-allocated compute infrastructure | Developer, Basic, Standard, Premium |
mtv1 |
Multitenant v1 | Shared infrastructure that supports native autoscaling and scaling down to zero in times of no traffic | Consumption |
For continued support and to take advantage of upcoming features, customers must migrate their Azure API Management instances from the stv1
compute platform to the stv2
compute platform. The stv2
compute platform comes with additional features and improvements such as support for Azure Private Link and other networking features.
New instances created in service tiers other than the Consumption tier are mostly hosted on the stv2
platform already. Existing instances on the stv1
compute platform will continue to work normally until the retirement date, but those instances won't receive the latest features available to the stv2
platform. Support for stv1
instances will be retired by 31 August 2024.
Is my service affected by this?
If the value of the platformVersion
property of your service is stv1
, it's hosted on the stv1
platform. See How do I know which platform hosts my API Management instance?
What is the deadline for the change?
Support for API Management instances hosted on the stv1
platform will be retired by 31 August 2024.
What do I need to do?
Migrate all your existing instances hosted on the stv1
compute platform to the stv2
compute platform.
If you have existing instances hosted on the stv1
platform, follow our migration guide to ensure a successful migration.
What happens after 31 August 2024?
Your stv1
instance will not be shut down, deactivated, or deleted. However, the SLA commitment for the instance ends, and any stv1
instance after the retirement date will be scheduled for automatic migration to the stv2
platform.
End of SLA commitment for stv1
instances
As of 1 September 2024, API Management will no longer provide any service level guarantees, and by extension service credits, for performance or availability issues related to the Developer, Basic, Standard, and Premium service instances running on the stv1
compute platform. Also, no new security and compliance investments will be made in the API Management stv1
platform.
Through continued use of an instance hosted on the stv1
platform beyond the retirement date, you acknowledge that Azure does not commit to the SLA of 99.95% for the retired instances.
Automatic migration
Starting 1 September 2024, we'll automatically migrate remaining stv1
service instances to the stv2
compute platform. All affected customers will be notified of the upcoming automatic migration a week in advance. Automatic migration might cause downtime for your upstream API consumers. You may still migrate your own instances before automatic migration takes place.
Help and support
If you have a support plan and you need technical help, create a support request.
- For Summary, type a description of your issue, for example, "stv1 retirement".
- Under Issue type, select Technical.
- Under Subscription, select your subscription.
- Under Service, select My services, then select API Management Service.
- Under Resource, select the Azure resource that you’re creating a support request for.
- For Problem type, select Administration and Management.
- For Problem subtype, select Upgrade, Scale or SKU Changes.
Note
Azure support can't extend the timeline for automatic migration or for SLA support of stv1
instances after the retirement date.