Merge pull request #273323 from dlepow/apiverret

[APIM] API version retirement

Author: ttorble

articles/api-management/TOC.yml

@@ -643,7 +643,7 @@
       href: breaking-changes/metrics-retirement-aug-2023.md
     - name: Virtual network changes (September 2023)
       href: breaking-changes/rp-source-ip-address-change-sep-2023.md
-    - name: API version retirements (September 2023)
+    - name: API version retirements (June 2024)
       href: breaking-changes/api-version-retirement-sep-2023.md
     - name: Self-hosted gateway v0/v1 retirements (October 2023)
       href: breaking-changes/self-hosted-gateway-v0-v1-retirement-oct-2023.md

articles/api-management/breaking-changes/api-version-retirement-sep-2023.md

@@ -1,33 +1,31 @@
 ---
-title: Azure API Management - API version retirements (September 2023) | Microsoft Docs
-description: The Azure API Management service is retiring all API versions prior to 2021-08-01. If you use one of these API versions, you must update your tools, scripts, or programs to use the latest versions.
+title: Azure API Management - API version retirements (June 2024) | Microsoft Docs
+description: Starting June 1, 2024, the Azure API Management service is retiring all API versions prior to 2021-08-01. If you use one of these API versions, you must update affected tools, scripts, or programs to use the latest versions.
 services: api-management
 author: dlepow
 ms.service: api-management
 ms.topic: reference
-ms.date: 11/06/2023
+ms.date: 04/26/2024
 ms.author: danlep
 ---
 
-# API version retirements (September 2023)
+# API version retirements (June 2024)
 
 [!INCLUDE [api-management-availability-premium-dev-standard-basic-consumption](../../../includes/api-management-availability-premium-dev-standard-basic-consumption.md)]
 
 Azure API Management uses Azure Resource Manager (ARM) to configure your API Management instances. The API version is embedded in your use of templates that describe your infrastructure, tools that are used to configure the service, and programs that you write to manage your Azure API Management services. 
 
-On 30 September 2023, all API versions for the Azure API Management service prior to **2021-08-01** will be retired and API calls using those API versions will fail. This means you'll no longer be able to create or manage your API Management services using your existing templates, tools, scripts, and programs until they've been updated. Data operations (such as accessing the APIs or Products configured on Azure API Management) will be unaffected by this update, including after 30 September 2023. 
-
-From now through 30 September 2023, you can continue to use the templates, tools, and programs without impact. You can transition to API version 2021-08-01 or later at any point prior to 30 September 2023. 
+Starting June 1, 2024, all API versions for the Azure API Management service prior to [**2021-08-01**](/rest/api/apimanagement/operation-groups?view=rest-apimanagement-2021-08-01) are being retired (disabled). The previously communicated retirement date was September 30, 2023. At any time after June 1, 2024, API calls using an API version prior to 2021-08-01 may fail without further notice. You'll no longer be able to create or manage your API Management services with existing templates, tools, scripts, and programs using a retired API version until they've been updated to use API version 2021-08-01 or later. Data plane operations (such as mediating API requests in the gateway) will be unaffected by this update, including after June 1, 2024.
 
 ## Is my service affected by this?
 
-While your service isn't affected by this change, any tool, script, or program that uses the Azure Resource Manager (such as the Azure CLI, Azure PowerShell, Azure API Management DevOps Resource Kit, or Terraform) to interact with the API Management service is affected by this change. You'll be unable to run those tools successfully unless you update the tools.
+While your service isn't affected by this change, any tool, script, or program that uses the Azure Resource Manager (such as the Azure CLI, Azure PowerShell, Azure API Management DevOps Resource Kit, or Terraform) to interact with the API Management service and calls an API Management API version prior to 2021-08-01 is affected by this change. After an API version is retired, you'll be unable to run any affected tools successfully unless you update the tools.
 
 ## What is the deadline for the change?
 
-The affected API versions will no longer be valid after 30 September 2023.
+The affected API versions will be retired gradually starting June 1, 2024.
 
-After 30 September 2023, if you prefer not to update your tools, scripts, and programs, your services will continue to run but you won't be able to add or remove APIs, change API policy, or otherwise configure your API Management service. 
+After an API version is retired, if you prefer not to update your affected tools, scripts, and programs, your services will continue to run. However, you won't be able to add or remove APIs, change API policy, or otherwise configure your API Management service with affected tools. 
 
 ## Required action
 
@@ -48,7 +46,7 @@ We also recommend setting the **Minimum API version** in your API Management ins
     * API Management DevOps Resource Kit: 1.0.0
     * Terraform azurerm provider: 3.0.0
 
-* **Azure SDKs** - Update the Azure API Management SDKs to the latest versions (or later): 
+* **Azure SDKs** - Update the Azure API Management SDKs to the latest versions or at least the following versions: 
     * .NET: 8.0.0 
     * Go: 1.0.0 
     * Python: 3.0.0 
@@ -57,18 +55,21 @@ We also recommend setting the **Minimum API version** in your API Management ins
 
 ### Update Minimum API version setting on your API Management instance
 
-We recommend setting the **Minimum API version** for your API Management instance using the Azure portal. This setting limits control plane API calls to your instance with an API version equal to or newer than this value. Currently you can set this to **2021-08-01**.
+We recommend setting the **Minimum API version** for your API Management instance using the Azure portal. This setting limits control plane API calls to your instance to an API version equal to or newer than this value. By setting this value to **2021-08-01**, you can assess the impact of the API version retirements on your tooling.
+
+
 
 To set the **Minimum API version** in the portal:
 
 1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
 1. In the left menu, under **Deployment + infrastructure**, select **Management API**.
 1. Select the **Management API settings** tab.
-1. Under **Prevent users with read-only permissions from accessing service secrets**, select **Yes**. The **Minimum API version** appears.
+1. Under **Enforce minimum API version**, select **Yes**. The **Minimum API version** appears.
 1. Select **Save**.
 
 ## More information
 
+* [Supported API Management API versions](/rest/api/apimanagement/operation-groups)
 * [Azure CLI](/cli/azure/update-azure-cli)
 * [Azure PowerShell](/powershell/azure/install-azure-powershell)
 * [Azure Resource Manager](../../azure-resource-manager/management/overview.md)
@@ -78,5 +79,4 @@ To set the **Minimum API version** in the portal:
 
 ## Related content
 
-See all [upcoming breaking changes and feature retirements](overview.md).
-
+See all [upcoming breaking changes and feature retirements](overview.md).

articles/api-management/breaking-changes/overview.md

@@ -21,7 +21,7 @@ The following table lists all the upcoming breaking changes and feature retireme
 | [Resource provider source IP address updates][bc1] | March 31, 2023 |
 | [Metrics retirements][metrics2023] | August 31, 2023 |
 | [Resource provider source IP address updates][rp2023] | September 30, 2023 |
-| [API version retirements][api2023] | September 30, 2023 |
+| [API version retirements][api2023] | June 1, 2024 |
 | [Deprecated (legacy) portal retirement][devportal2023] | October 31, 2023 |
 | [Self-hosted gateway v0/v1 retirement][shgwv0v1] | October 1, 2023 |
 | [Workspaces breaking changes][workspaces2024] | June 14, 2024 |