Use Service Upgrade and Retirement recommendations

Learn how to use Service Upgrade and Retirement recommendations.

Overview

Azure services periodically undergo a retirement and upgrade journey, necessitating you to upgrade to the most current versions to ensure security, functionality, and support. Now, Azure Advisor includes integrated service upgrade and retirement recommendations, providing you with critical guidance on upcoming service updates.

Access recommendations

The Service Upgrade and Retirement subcategory of recommendations under Reliability category, includes both upgrade and retirement recommendations. The upgrade and retirement recommendations are a superset of the retirement updates provided using customer communication. The recommendations intended for upgrades but not associated with any retirements have Retirement Date and Retiring Feature values marked as N/A or null.

Previously, retirement recommendations were only available through Advisor workbooks that are in preview mode. Now, you also have access to the information using the native user experience in Azure Advisor and Azure Advisor REST API requests. Based on your requirements and comfort, choose your route.

Note

Only recommendations with available Impacted resources information are displayed in Advisor panes. The Advisor API response provides the same information. For more information about Impacted resources, see Coverage of Services.

Recommendations pane

To use the native user experience in Azure Advisor, complete the following actions.

1. In Azure Advisor, select Recommendations > Reliability.

2. On Reliability pane, select Add filter.

   

3. On Add filter, select Recommendation Subcategory.

   

4. On Recommendation Subcategory, select Service Upgrade and Retirement and Apply.

   

   Your selection for the scope of the subscription and the filters changes the list of recommendations applicable for your resources. Locate the date of retirement in the column under Retirement date and the feature being retired in the column under Retiring feature.

   

5. Select a recommendation.

   The detailed view of the recommendation includes the Retirement date, Retiring feature, and the list of Impacted Resources.

   

All retirements metadata using API

To get a list of all of the upgrade and retirement recommendations, use the Recommendation Metadata - List API request.

Sample Recommendation Metadata - List API request

The following code sample uses 2025-01-01 for the api-version.

https://management.azure.com/providers/Microsoft.Advisor/metadata?api-version=2025-01-01&$filter=recommendationCategory eq 'HighAvailability' and recommendationSubCategory eq 'ServiceUpgradeAndRetirement'

Note

recommendationControl is a legacy filter property and is planned for deprecation in the future. Use recommendationSubCategory for filtering recommendation subcategory.

Sample Recommendation Metadata - List API response

"supportedValues": [
    {
        "recommendationCategory": "HighAvailability",
        "recommendationDataSourceQuery": "resources | where type == '<Azure-Resource-Manager-Resource-Details>' and properties.kind == 'ping' | project subscriptionId, id",
        "recommendationImpact": "Medium",
        "supportedResourceType": "<Azure-Resource-Manager-Resource-Details>",
        "recommendationControl": "ServiceUpgradeAndRetirement",
        "id": "<Recommendation-Type-Id-Guid>",
        "displayName": "<Description-Of-The-Recommendation",
        "properties": [
            {
                "name": "recommendationCategory",
                "value": "HighAvailability"
            },
            {
                "name": "recommendationImpact",
                "value": "Medium"
            },
            {
                "name": "supportedResourceType",
                "value": "<Azure-Resource-Manager-Resource-Details>"
            }
        ],
        "sourceProperties": {
            "serviceRetirement": {
                "retirementDate": "<Retirement-Date-YYY-MM-dd>",
                "retirementFeatureName": "<Name-Of-The-Retiring-Feature>"
            }
        }
    }
]

Based on the details of the subscription, the Recommendation Metadata - List API response returns the list of applicable lists of the service upgrade and retirement recommendations.

Add the following filter to get more information like learnMoreLink, details of the recommendation, recommended action, and so on.

$expand=ibiza

Impacted Resources for retirements using API

To get a list of all of the upgrade and retirement recommendations with Impacted Resources, use the Recommendations - List API request.

For more information about Impacted Resources, see Coverage of Services.

To get list of Impacted Resources in a subscription by the retirement and recommendations, use the Recommendations - List API request.

Sample Recommendations - List API request

The following code sample uses 2025-01-01 for the api-version.

https://management.azure.com/subscriptions/<Subscription-Id-Guid>/providers/Microsoft.Advisor/recommendations?api-version=2025-01-01&$filter=Category eq 'HighAvailability' and SubCategory eq 'ServiceUpgradeAndRetirement'

Note

recommendationControl is a legacy filter property and is planned for deprecation in the future. Use recommendationSubCategory for filtering recommendation subcategory.

Sample Recommendations - List API response

{
    "value": [
        {
            "properties": {
                "category": "HighAvailability",
                "impact": "Medium",
                "impactedField": "MICROSOFT.INSIGHTS/WEBTESTS",
                "impactedValue": "<Impacted-Value-Text>",
                "lastUpdated": "ast-Updated-YYYY-MM-ddThh:mm:ssZ",
                "recommendationTypeId": "<Recommendation-Type-Id-Guid>",
                "shortDescription": {
                    "problem": "<Description-Of-The-Recommendation>",
                    "solution": "The URL ping test capability of the application insights feature for Azure Monitor is being retired."
                },
                "extendedProperties": {
                    "recommendationControl": "ServiceUpgradeAndRetirement",
                    "maturityLevel": "Preview",
                    "retirementDate": "<Retirement-Date-YYY-MM-dd>",
                    "retirementFeatureName": "<Name-Of-The-Retiring-Feature>",
                    "recommendationOfferingId": "<Recommendation-Offering-Id-Guid>"
                },
                "resourceMetadata": {
                    "ResourceId": "/subscription/<Subscription-Id>/resourceGroups/<Resource-Group-Name>/providers/<Azure-Resource-Manager-Resource-Details>/<Impacted-Value-Text>"
                },
                "id": "/subscription/<Subscription-Id>/resourceGroups/<Resource-Group-Name>/providers/<Azure-Resource-Manager-Resource-Details>/<Impacted-Value-Text>/providers/Microsoft.Advisor/recommendations/<Recommendation-Guid>",
                "type": "Microsoft.Advisor/recommendations",
                "name": "<Recommendation-Guid>"
            }
        }
    ]
}

Add the following filter to get more information like learnMoreLink, details of the recommendation, recommended action, and so on.

$expand=ibiza,details

All retirements using Azure Resource Graph query

The retirement recommendations are available in the native user experience in Advisor and accessible using Azure Resource Graph. To get the list of Impacted Resources, use an Azure Resource Graph query.

Sample Azure Resource Graph query

advisorresources
| where type == "microsoft.advisor/recommendations"
| where properties.category == "HighAvailability"
| where properties.extendedProperties.recommendationSubCategory == "ServiceUpgradeAndRetirement"
| extend retirementFeatureName = properties.extendedProperties.retirementFeatureName
| extend retirementDate = properties.extendedProperties.retirementDate
| extend resourceId = properties.resourceMetadata.resourceId
| extend shortDescription = properties.shortDescription.problem
// To exclude upgrade recommendations that are not linked to any retirement
| where retirementFeatureName != ''
| project retirementFeatureName, retirementDate, resourceId, shortDescription

Coverage of services

Although the current coverage of services for retirement recommendations in Advisor isn't comprehensive, it serves as a solid starting point. At the current time, the platform doesn't have information about the Impacted Resources for a subset of recommendations. Based on your need, use any of the listed ways to get the required information.

Retiring in 2025

Retiring November 2025

November 1, 2025

Service name	Retiring feature	Impacted Resources available?
Storage Account	Support for TLS 1.0	✅
Storage Account	Support for TLS 1.1	✅

November 9, 2025

Service name	Retiring feature	Impacted Resources available?
Azure Database for PostgreSQL	FlexibleServers - Version 11	✅

Retiring in 2026

Retiring February 2026

February 28, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Data Studio	Entire service	To be updated soon.
Log Analytics Ingestion	Support for TLS 1.0	To be updated soon.
Log Analytics Ingestion	Support for TLS 1.1	To be updated soon.

Retiring March 2026

March 13, 2026

Service name	Retiring feature	Impacted Resources available?
Speech service	Speech-to-text REST preview API v3.1-preview.1	To be updated soon.

March 15, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Database Migration Service (classic)	SQL Server scenarios	To be updated soon.
Microsoft Sentinel	Alert-trigger playbooks	To be updated soon.

March 16, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Machine Learning	Batch Endpoints Preview APIs	To be updated soon.
Kubernetes Cluster	AKS on VMware	✅

March 29, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Site Recovery	Classic VMware protection	To be updated soon.

March 30, 2026

Service name	Retiring feature	Impacted Resources available?
Container Apps	Service Connector in ACA	✅

March 31, 2026

Service name	Retiring feature	Impacted Resources available?
Application Insights	API keys for querying	To be updated soon.
Azure Active Directory	Conditional Access policies that use only the Require Approved Client App grant	To be updated soon.
Azure Backup	Classic alerts for Recovery Services vaults	To be updated soon.
Azure Batch	Availability in select regions	To be updated soon.
Azure Batch	Classic compute node communication model	To be updated soon.
Azure Batch	Custom image pools using VHD blobs in Azure Storage and Azure Managed Images	To be updated soon.
Azure Kubernetes	Windows Server 2019 on AKS hybrid	To be updated soon.
Azure Log Analytics	Custom fields	To be updated soon.
Azure Monitor	Azure Diagnostic Extensions	To be updated soon.
Intelligent Recommendations	Entire service	✅

Retiring April 2026

April 28, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Application Gateway	v1	✅

April 30, 2026

Service name	Retiring feature	Impacted Resources available?
Azure AI Speech	Custom Commands	To be updated soon.
Azure App Service	Support for Node 20 LTS	✅

Retiring May 2026

May 12, 2026

Service name	Retiring feature	Impacted Resources available?
App Service	.NET 9 (STS)	✅
Azure Storage	Data Movement Library	To be updated soon.

Retiring June 2026

June 1, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Price Sheet	Download by Billing Account APIs prior to version 2023-09-01	To be updated soon.

June 30, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Machine Learning	V1 SDK	To be updated soon.
Entra Domain Services	Support for TLS 1.0	✅
Entra Domain Services	Support for TLS 1.1	✅
Virtual Machines	DCsv2-series	✅

Retiring August 2026

August 31, 2026

Service name	Retiring feature	Impacted Resources available?
Azure AI Document Intelligence	v2.0 API	To be updated soon.

Retiring September 2026

September 13, 2026

Service name	Retiring feature	Impacted Resources available?
Azure AI Vision	Computer Vision API v1.0	To be updated soon.
Azure AI Vision	Computer Vision API v2.0	To be updated soon.
Azure AI Vision	Computer Vision API v2.1	To be updated soon.
Azure AI Vision	Computer Vision API v3.0	To be updated soon.
Azure AI Vision	Computer Vision API v3.1	To be updated soon.

September 14 2026

Service name	Retiring feature	Impacted Resources available?
AKS-Engine	Monitoring Support	To be updated soon.
Azure Functions	Version 1.x runtime	To be updated soon.
Azure Monitor	HTTP Data Collector API	To be updated soon.

September 15, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Maps	Gen1 price tier	✅
Azure Monitor	Legacy Azure Activity logs solution	To be updated soon.

September 17, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Maps	Render v1 APIs	To be updated soon.

September 19, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Maps	Web SDK Map Controls v1.xx	To be updated soon.

September 21, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Health Data Services	SMART on FHIR proxy	✅

September 30, 2026

Service name	Retiring feature	Impacted Resources available?
Application Insights	Single URL Ping Test	To be updated soon.
Azure API for FHIR	Entire service	✅
Azure Container Registry	2017-01-01-(GA) API	To be updated soon.
Azure FXT Edge Filer	Entire service	To be updated soon.
Azure Maps	Web SDK v2 Subversion (v2.0 - v2.0.32)	To be updated soon.
Azure Monitor	Alerts - GetAlertSummary API	To be updated soon.
Azure Monitor	ContainerLog table	To be updated soon.
Azure Virtual Desktop	Classic	To be updated soon.
Service Bus	com.microsoft.azure.servicebus	To be updated soon.
Service Bus	Outdated Azure SDK libraries	To be updated soon.
Virtual Machines	NVv3-Series	✅
Virtual Machines	NVv4-series Azure Virtual Machines	✅
VPN Gateway	Non-availability zones VPNs	✅

Retiring October 2026

October 1, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Anomaly Detector	Entire service	✅
Azure Metrics Advisor	Entire service	✅
Azure Personalizer	Entire service	✅
Azure SQL Database	FSV2 Database	✅
Cognitive Services Translator	S2 price instance	To be updated soon.
Cognitive Services Translator	S3 price instance	To be updated soon.
Cognitive Services Translator	S4 price instance	To be updated soon.
Databricks Workspaces	Azure Databricks - Standard Tier	✅

Retiring November 2026

November 10, 2026

Service name	Retiring feature	Impacted Resources available?
Azure Functions	In-process model	To be updated soon.

Retiring December 2026

December 31, 2026

Service name	Retiring feature	Impacted Resources available?
App Service	PHP 8.2	✅

Retiring in 2027

Retiring January 2027

January 12, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Batch	HPC Pack 2016	To be updated soon.

Retiring March 2027

March 15, 2027

Service name	Retiring feature	Impacted Resources available?
Azure AI Content Moderator	Entire service	✅

March 17, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Kubernetes Service	Support for Ubuntu 20.04	✅

March 31, 2027

Service name	Retiring feature	Impacted Resources available?
API Management	Built-in Analytics	To be updated soon.
Application Gateway	WAF v2 Config	✅
Azure App Service	Docker Compose	✅
Azure Data Factory	Memory Optimized Data Flows	To be updated soon.
Azure Front Door	Classic	To be updated soon.
Cloud Service Extended Support	Entire service	✅
Redis Enterprise	Redis Enterprise	✅
Virtual Machines	Standard_M192idms_v2	✅
Virtual Machines	Standard_M192ids_v2	✅
Virtual Machines	Standard_M192ims_v2	✅
Virtual Machines	Standard_M192is_v2	✅

Retiring April 2027

April 1, 2027

Service name	Retiring feature	Impacted Resources available?
Azure text to speech	Long audio API	To be updated soon.

Retiring June 2027

June 28, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Lab Services - Lab Accounts	v1	✅
Azure Lab Services - Lab Accounts	v2	✅
Azure Lab Services - Lab Plans	v1	✅
Azure Lab Services - Lab Plans	v2	✅
Azure Lab Services - Labs	v1	✅
Azure Lab Services - Labs	v2	✅

Retiring July 2027

July 1, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Fluid Relay Service	Outdated client library	✅

Retiring September 2027

September 15, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Document Intelligence	Studio v2.1	To be updated soon.

September 17, 2027

Service name	Retiring feature	Impacted Resources available?
Azure SQL	Automated patching for SQL VMs	To be updated soon.

September 22, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Site Recovery	Classic Alerts	To be updated soon.

September 26, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Sphere	Public API	To be updated soon.

September 30, 2027

Service name	Retiring feature	Impacted Resources available?
Azure Automanage	Best Practices	To be updated soon.
Azure Automation	State Configuration (DSC)	To be updated soon.
Azure CDN	Standard from Microsoft (classic)	✅
Azure Kubernetes Service	Open Service Mesh add-on	To be updated soon.
Azure Load Balancer	Inbound NAT rule V1	✅
Azure SQL	Data Sync	To be updated soon.
Network Watcher	NSG Flow Logs	To be updated soon.

Retiring in 2028

Retiring March 2028

March 17, 2028

Service name	Retiring feature	Impacted Resources available?
Azure Kubernetes Service	Deployments on Windows Server 2019	✅
Azure Kubernetes Service	Deployments on Windows Server 2022	✅

March 31, 2028

Service name	Retiring feature	Impacted Resources available?
Azure App Service	Customer Backup - Linked Database Backups	✅
Azure Container Registry	Support for Docker Content Trust	✅
Azure Kubernetes Service	Kubenet Networking	✅
Azure Log Analytics	batch API	To be updated soon.
Azure Maps	Route v1 APIs	✅
Azure Maps	Traffic v1 APIs	✅
Azure Spring Apps	Entire service	✅
Azure Virtual Machines	Desired State Configuration Extension	✅
Azure Virtual Machines	D series	✅
Azure Virtual Machines	Ds series	✅
Azure Virtual Machines	Dsv2 series	✅
Azure Virtual Machines	Dv2 series	✅
Azure Virtual Machines	Ls series	✅
Log Analytics	batch API	To be updated soon.
Microsoft Entra ID	Manually registered Azure VPN clients	✅
Microsoft Entra ID	VPN Gateway with Third-party App	✅

Retiring September 2028

September 1, 2028

Service name	Retiring feature	Impacted Resources available?
Cognitive Services Accounts	Cognitive Services Text Analytics API - Entity Linking	✅

September 15, 2028

Service name	Retiring feature	Impacted Resources available?
Virtual Machine Scale Set	Virtual Machine and Virtual Machine Scale Set - Azure Disk Encryption	✅

September 30, 2028

Service name	Retiring feature	Impacted Resources available?
Redis Cache	Redis Cache	✅

Retiring November 2028

November 15, 2028

Service name	Retiring feature	Impacted Resources available?
Virtual Machines	Av2 - Series	✅
Virtual Machines	B - Series	✅
Virtual Machines	F - Series	✅
Virtual Machines	FS - Series	✅
Virtual Machines	Fsv2 - Series	✅
Virtual Machines	G - Series	✅
Virtual Machines	LGS - Series	✅
Virtual Machines	LSv2 - Series	✅

Conclusion

If you utilize the retirement recommendations in Advisor, you ensure your services remain secure and efficient. Regularly review and act on the upgrade and retirement recommendations to help maintain the integrity and functionality of your Azure resources to ultimately lead you to a more robust and resilient cloud environment.

Related articles

For more information about Azure Advisor, see the following articles.

• Introduction to Azure Advisor

• Azure Advisor portal basics

• Use Advisor score

• Service Retirement workbook

For more information about specific Advisor recommendations, see the following articles.

• Reliability recommendations

• Cost recommendations

• Performance recommendations

• Review security recommendations

• Operational excellence recommendations

For more information about Advisor REST API, see the following articles.

• Azure Advisor REST API

• Recommendations - List

• Recommendation Metadata - List

For more information about Azure communication and Azure Resource Graph, see the following articles.

• Azure Updates

• Azure Advisor