diff --git a/docs/content/services/integration/api-management/_index.md b/docs/content/services/integration/api-management/_index.md index ce7a841aa..48eae1654 100644 --- a/docs/content/services/integration/api-management/_index.md +++ b/docs/content/services/integration/api-management/_index.md @@ -16,6 +16,7 @@ The presented resiliency recommendations in this guidance include Api Management |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------:|:------:|:-------:|:-------------------:| | [APIM-1 - Migrate API Management services to Premium SKU to support Availability Zones](#apim-1---migrate-api-management-services-to-premium-sku-to-support-availability-zones) | Availability | High | Preview | Yes | | [APIM-2 - Enable Availability Zones on Premium API Management instances](#apim-2---enable-availability-zones-on-premium-api-management-instances) | Availability | High | Preview | Yes | +| [APIM-3 - Upgrade to platform version stv2](#apim-3---upgrade-to-platform-version-stv2) | Availability | High | Preview | Yes | {{< /table >}} {{< alert style="info" >}} @@ -75,3 +76,28 @@ Enable zone redundancy for APIM instances. With zone redundancy, the gateway and {{< /collapse >}}

+ +### APIM-3 - Upgrade to platform version stv2 + +**Category: Availability** + +**Impact: High** + +**Guidance** + +Upgrade to platform version stv2. 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. + +**Resources** + +- [Azure API Management - stv1 platform retirement (August 2024)](https://learn.microsoft.com/en-us/azure/api-management/breaking-changes/stv1-platform-retirement-august-2024) +- [Azure API Management compute platform](https://learn.microsoft.com/en-us/azure/api-management/compute-infrastructure) + +**Resource Graph Query/Scripts** + +{{< collapse title="Show/Hide Query/Script" >}} + +{{< code lang="sql" file="code/apim-3/apim-3.kql" >}} {{< /code >}} + +{{< /collapse >}} + +

diff --git a/docs/content/services/integration/api-management/code/apim-3/apim-3.kql b/docs/content/services/integration/api-management/code/apim-3/apim-3.kql new file mode 100644 index 000000000..ffee4ee92 --- /dev/null +++ b/docs/content/services/integration/api-management/code/apim-3/apim-3.kql @@ -0,0 +1,8 @@ +// Azure Resource Graph Query +// Find all API Management instances that aren't upgraded to platform version stv2 +resources +| where type =~ 'Microsoft.ApiManagement/service' +| extend plat_version = properties.platformVersion +| extend skuName = sku.name +| where tolower(plat_version) != tolower('stv2') +| project recommendationId = "apim-3", name, id, tags, param1=strcat("Platform Version: ", plat_version) , param2=strcat("SKU: ", skuName)