Merge pull request #284118 from dlepow/stv1mc

[APIM] stv1 retirement - USGov and MC, VNet migration options

Author: denrea

articles/api-management/breaking-changes/stv1-platform-retirement-august-2024.md

@@ -1,19 +1,22 @@
 ---
-title: Azure API Management - stv1 platform retirement (August 2024) | Microsoft Docs
-description: Azure API Management will retire the stv1 compute platform effective 31 August 2024. Instances hosted on the stv1 platform must be migrated to the stv2 platform.
+title: Azure API Management - global Azure - stv1 platform retirement (August 2024)
+description: In the global Azure cloud, Azure API Management will retire stv1 compute platform effective 31 August 2024. Instances must be migrated to stv2 platform.
 services: api-management
 author: dlepow
 ms.service: azure-api-management
 ms.topic: reference
-ms.date: 12/19/2023
+ms.date: 08/08/2024
 ms.author: danlep
 ---
 
-# stv1 platform retirement (August 2024)
+# API Management stv1 platform retirement - Global Azure cloud (August 2024)
 
 [!INCLUDE [api-management-availability-premium-dev-standard-basic](../../../includes/api-management-availability-premium-dev-standard-basic.md)]
 
-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. 
+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 in the global Microsoft Azure cloud.** A more current compute platform version (`stv2`) is already available, and provides enhanced service capabilities.
+
+> [!NOTE]
+> For API Management instances deployed in Microsoft Azure Government cloud or Microsoft Azure operated by 21Vianet cloud (Azure in China), the retirement date for the `stv1` platform is 28 February 2025. [Learn more](stv1-platform-retirement-sovereign-clouds-february-2025.md)
 
 The following table summarizes the compute platforms currently used for instances in the different API Management service tiers. 
 
@@ -38,7 +41,6 @@ Support for API Management instances hosted on the `stv1` platform will be retir
 > [!WARNING]
 > If your instance is currently hosted on the `stv1` platform, you must migrate to the `stv2` platform. Failure to migrate by the retirement date might result in loss of the environments running APIs and all configuration data.
 
-
 ## What do I need to do?
 
 **Migrate all your existing instances hosted on the `stv1` compute platform to the `stv2` compute platform by 31 August 2024.**  

articles/api-management/breaking-changes/stv1-platform-retirement-sovereign-clouds-february-2025.md

@@ -0,0 +1,53 @@
+---
+title: Azure API Management - stv1 platform retirement - Azure Government, Azure in China (February 2025)
+description: In Azure Government and Azure operated by 21Vianet, API Management will retire stv1 platform effective 28 February 2025. Instances must be migrated to stv2 platform.
+services: api-management
+author: dlepow
+ms.service: azure-api-management
+ms.topic: reference
+ms.date: 08/09/2024
+ms.author: danlep
+---
+
+# API Management stv1 platform retirement - Azure Government and Azure operated by 21Vianet  (February 2025)
+
+[!INCLUDE [api-management-availability-premium-dev-standard-basic](../../../includes/api-management-availability-premium-dev-standard-basic.md)]
+
+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 28 February 2025 in Microsoft Azure Government and in Microsoft Azure operated by 21 Vianet (Azure in China).** A more current compute platform version (`stv2`) is already available, and provides enhanced service capabilities.
+
+> [!NOTE]
+> For API Management instances deployed in global Microsoft Azure, the retirement date for the `stv1` platform is 31 August 2024. [Learn more](stv1-platform-retirement-august-2024.md)
+
+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` | Multi-tenant 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](../migrate-stv1-to-stv2.md) 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.   
+
+## 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?](../compute-infrastructure.md#how-do-i-know-which-platform-hosts-my-api-management-instance)
+
+## What is the deadline for the change?
+
+In Azure Government and Azure operated by 21Vianet, support for API Management instances hosted on the `stv1` platform will be retired by 28 February 2025.
+
+## What do I need to do?
+
+**Migrate all your existing instances hosted on the `stv1` compute platform to the `stv2` compute platform by 28 February 2025.**  
+
+If you have existing instances hosted on the `stv1` platform, follow our **[migration guide](../migrate-stv1-to-stv2.md)** to ensure a successful migration. 
+
+[!INCLUDE [api-management-migration-support](../../../includes/api-management-migration-support.md)]
+
+
+## Related content
+
+* [Migrate from stv1 platform to stv2](../migrate-stv1-to-stv2.md)
+* See all [upcoming breaking changes and feature retirements](overview.md).

articles/api-management/media/migrate-stv1-to-stv2-vnet/enable-retain-gateway-small.png

@@ -69,22 +69,7 @@ You can choose whether the virtual IP address of API Management will change, or
 
 #### [Azure CLI](#tab/cli)
 
-Run the following Azure CLI commands, setting variables where indicated with the name of your API Management instance and the name of the resource group in which it was created.
-> [!NOTE]
-> The Migrate to `stv2` REST API is available starting in API Management REST API version `2022-04-01-preview`.
-> [!NOTE]
-> The following script is written for the bash shell. To run the script in PowerShell, prefix the variable names with the `$` character. Example: `$APIM_NAME`.
-
-```azurecli
-APIM_NAME={name of your API Management instance}
-RG_NAME={name of your resource group}
-# Get resource ID of API Management instance
-APIM_RESOURCE_ID=$(az apim show --name $APIM_NAME --resource-group $RG_NAME --query id --output tsv)
-# Call REST API to migrate to stv2 and change VIP address
-az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "NewIp"}'
-# Alternate call to migrate to stv2 and preserve VIP address
-# az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "PreserveIp"}'
-```
+[!INCLUDE [api-management-migration-cli-steps](../../includes/api-management-migration-cli-steps.md)]
 ---
 
 [!INCLUDE [api-management-validate-migration-to-stv2](../../includes/api-management-validate-migration-to-stv2.md)]