Skip to content

Commit 0d23a91

Browse files
committed
update for platform version exposed in portal Overview
1 parent ef230f8 commit 0d23a91

File tree

3 files changed

+13
-17
lines changed

3 files changed

+13
-17
lines changed

articles/api-management/compute-infrastructure.md

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn about the compute platform used to host your API Management s
44
author: dlepow
55
ms.service: api-management
66
ms.topic: conceptual
7-
ms.date: 01/20/2023
7+
ms.date: 02/01/2023
88
ms.author: danlep
99
ms.custom:
1010
---
@@ -33,32 +33,28 @@ The following table summarizes the compute platforms currently used for instance
3333
3434
## How do I know which platform hosts my API Management instance?
3535

36-
Starting with API version `2021-04-01-preview`, the API Management instance exposes a read-only `platformVersion` property that shows this platform information.
36+
Starting with API version `2021-04-01-preview`, the API Management instance exposes a read-only `platformVersion` property with this platform information.
3737

38-
You can find this information using the portal or the API Management [REST API](/rest/api/apimanagement/current-ga/api-management-service/get).
38+
You can find the platform version of your instance using the portal, the API Management [REST API](/rest/api/apimanagement/current-ga/api-management-service/get), or other Azure tools.
3939

40-
To find the `platformVersion` property in the portal:
40+
To find the platform version in the portal:
4141

4242
1. Go to your API Management instance.
43-
1. On the **Overview** page, select **JSON view**.
44-
1. In **API version**, select a current version such as `2021-08-01` or later.
45-
1. In the JSON view, scroll down to find the `platformVersion` property.
43+
1. On the **Overview** page, the **Platform Version** is displayed.
4644

47-
:::image type="content" source="media/compute-infrastructure/platformversion-property.png" alt-text="platformVersion property in JSON view":::
45+
:::image type="content" source="media/compute-infrastructure/platformversion-property.png" alt-text="Screenshot of the API Management platform version in the portal.":::
4846

4947
## How do I migrate to the `stv2` platform?
5048

5149
> [!IMPORTANT]
5250
> Support for API Management instances hosted on the `stv1` platform will be [retired by 31 August 2024](breaking-changes/stv1-platform-retirement-august-2024.md). To ensure proper operation of your API Management instance, you should migrate any instance hosted on the `stv1` platform to `stv2` before that date.
5351
54-
To migrate an instance from the `stv1` platform to `stv2`:
52+
Migration steps depend on features enabled in your API Management instance. For details, see the [migration guidance](migrate-stv1-to-stv2.md):
5553

5654
* **Non-VNet-injected API Management instance** - Use the [Migrate to stv2](/rest/api/apimanagement/current-preview/api-management-service/migratetostv2) REST API
5755

5856
* **VNet-injected API Management instance** - Update the VNet connection, or enable zone redundancy
5957

60-
For details, see the [migration guidance](migrate-stv1-to-stv2.md).
61-
6258
## Next steps
6359

6460
* Learn more about using a [virtual network](virtual-network-concepts.md) with API Management.
-46.4 KB
Loading

articles/api-management/migrate-stv1-to-stv2.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
---
22
title: Migrate Azure API Management instance to stv2 platform | Microsoft Docs
3-
description: Follow the steps in this article to migrate your Azure API Management instance automatically from the stv1 compute platform to the stv2 compute platform. Migration steps depend on whether the instance is deployed (injected) in a VNet.
3+
description: Follow the steps in this article to migrate your Azure API Management instance from the stv1 compute platform to the stv2 compute platform. Migration steps depend on whether the instance is deployed (injected) in a VNet.
44

55
author: dlepow
66
ms.service: api-management
7-
ms.custom:
87
ms.topic: how-to
9-
ms.date: 01/20/2023
8+
ms.date: 02/01/2023
109
ms.author: danlep
1110

1211
---
1312

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

16-
An API Management instance hosted on the `stv1` compute platform can be migrated to the `stv2` platform. Migration steps depend on whether or not your API Management is currently deployed (injected) in an [external](api-management-using-with-vnet.md) or [internal](api-management-using-with-internal-vnet.md) VNet.
15+
You can migrate an API Management instance hosted on the `stv1` compute platform to the `stv2` platform. This article provides migration steps for two scenarios, depending on whether or not your API Management instance is currently deployed (injected) in an [external](api-management-using-with-vnet.md) or [internal](api-management-using-with-internal-vnet.md) VNet.
1716

1817
* **Non-VNet-injected API Management instance** - Use the [Migrate to stv2](/rest/api/apimanagement/current-preview/api-management-service/migratetostv2) REST API
1918

@@ -74,7 +73,8 @@ Trigger migration of a network-injected API Management instance to the `stv2` pl
7473

7574
* A new or existing Standard SKU [public IPv4 address](../virtual-network/ip-services/public-ip-addresses.md#sku) resource in the same region and subscription as your API Management instance.
7675

77-
For more information, see [Prerequisites for network connections](api-management-using-with-vnet.md#prerequisites).
76+
For details, see [Prerequisites for network connections](api-management-using-with-vnet.md#prerequisites).
77+
7878
#### Update VNet configuration
7979

8080
To update the existing external or internal VNet configuration:
@@ -95,7 +95,7 @@ The virtual network configuration is updated, and the instance is migrated to th
9595

9696
## Verify migration
9797

98-
To verify that the migration was successful, check the [`platformVersion` property](compute-infrastructure.md#how-do-i-know-which-platform-hosts-my-api-management-instance) of your API Management instance. After successful migration, the value is `stv2`.
98+
To verify that the migration was successful, check the [platform version](compute-infrastructure.md#how-do-i-know-which-platform-hosts-my-api-management-instance) of your API Management instance. After successful migration, the value is `stv2`.
9999

100100
## Next steps
101101

0 commit comments

Comments
 (0)