Impacted resources from Azure Retirements

To support of the experience of viewing Impacted Resources, Service Health has features to:

  • Display resources that are impacted due to a Retirement.
  • Provide impacted resources information for retirements through the Service Health Portal.

This article details what communication is available to users, and where they can view information about their impacted resources.

Note

The Impacted Resources tab for retirements displays information for a subset of services and features currently in the retirement lifecycle.

Viewing impacted resources for Retirements in the Service Health portal

In the Azure portal, the Impacted Resources tab located in the Health advisories panel displays the resources affected by a retirement event. The example here illustrates how the tab highlights a retirement scenario with impacted resources.

Screenshot of Health advisories panel.

They're shown in the Impacted Resources tab.

Screenshot of Impacted Resources tab.

Service Health provides the following information on resources impacted by a Retirement.

Field Description
Resource Name The name of the resource impacted by the planned maintenance event.
Resource Type The type of resource impacted by the planned maintenance event.
Resource Group The Resource group that contains the impacted resource.
Region The region where the impacted resource is located.
Subscription ID The Unique ID for the subscription that contains the impacted resource.
Subscription name The name of the subscription that contains the impacted resource.

Filter the results

You can filter the results through:

  • Region
  • Subscription ID
  • Resource Type

Screenshot of filters.

Export to a CSV file

Select the Export to CSV to export the list of impacted resources to an Excel file.

Screenshot of exported CSV file.

The CSV file contains the following fields:

Column property Description
ResourceGroup The name of the Resource group.
ResourceName The name of the impacted resource.
ResourceType The type of resource impacted.
Subscription Any SubscriptionId's that are in the scope of the published event.
Region The location where the affected resources are located.

Access impacted resources programmatically

Follow these steps to get information about retirement-impacted resources.

Step 1. Use API Query

Get the ID for the event using the Recommendation Metadata API. For more information, see Recommendation Metadata - List - REST API.

| GET https://management.chinacloudapi.cn/providers/Microsoft.Advisor/metadata?api-version=2025-01-01&$filter={$filter}

URI Parameters

Name In Required Type Description
api-version query True string The version of the API to be used with the client request.
Example: 2025-05-01
$filter query string Example:
- $filter= trackingIds/any(t: t eq ' TEST-123')

Sample response

{
    "value": [
        {
            "properties": {
                "displayName": "Recommendation Type",
                "dependsOn": [
                    "recommendationCategory",
                    "recommendationImpact",
                    "supportedResourceType"
                ],
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "recommendationCategory": "HighAvailability",
                        "recommendationDataSourceQuery": "resources | where type =~ 'Microsoft.Network/loadBalancers' | where sku.name == 'Basic' | project id, subscriptionId",
                        "recommendationImpact": "Medium",
                        "supportedResourceType": "microsoft.network/loadbalancers",
                        "recommendationSubCategory": "ServiceUpgradeAndRetirement",
                        "id": "7e570000-n78d-yh67-2xzc4-v16005e1k",
                        "displayName": "Azure Basic Load Balancer is being retired",
                        "properties": [
                            {
                                "name": "recommendationCategory",
                                "value": "HighAvailability"
                            },
                            {
                                "name": "recommendationImpact",
                                "value": "Medium"
                            },
                            {
                                "name": "supportedResourceType",
                                "value": "microsoft.network/loadbalancers"
                            }
                        ],
                        "recommendationControl": "ServiceUpgradeAndRetirement",
                        "sourceProperties": {
                            "serviceRetirement": {
                                "retirementDate": "2025-09-30",
                                "retirementFeatureName": "Basic Load Balancer",
                                "serviceHealth": {
                                    "trackingIds": [
                                        "TEST-123"
                                    ]
                                }
                            }
                        },
                        "_rid": "",
                        "_self": "",
                        "_etag": "",
                        "_attachments": "attachments/",
                        "_ts": 
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/recommendationType",
            "type": "Microsoft.Advisor/metadata",
            "name": "recommendationType"
        },
        {
            "properties": {
                "displayName": "Category",
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "id": "HighAvailability",
                        "displayName": "High Availability"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/recommendationCategory",
            "type": "Microsoft.Advisor/metadata",
            "name": "recommendationCategory"
        },
        {
            "properties": {
                "displayName": "Impact",
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "id": "Medium",
                        "displayName": "Medium"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/recommendationImpact",
            "type": "Microsoft.Advisor/metadata",
            "name": "recommendationImpact"
        },
        {
            "properties": {
                "displayName": "Supported Resource Type",
                "supportedValues": [
                    {
                        "id": "microsoft.network/loadbalancers",
                        "displayName": "Load balancer"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/supportedResourceType",
            "type": "Microsoft.Advisor/metadata",
            "name": "supportedResourceType"
        },
        {
            "properties": {
                "displayName": "Level",
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "id": "Informational",
                        "displayName": "Informational"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/level",
            "type": "Microsoft.Advisor/metadata",
            "name": "level"
        },
        {
            "properties": {
                "displayName": "Status",
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "id": "Active",
                        "displayName": "Active"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/status",
            "type": "Microsoft.Advisor/metadata",
            "name": "status"
        },
        {
            "properties": {
                "displayName": "Initiated By",
                "applicableScenarios": [
                    "Alerts"
                ],
                "supportedValues": [
                    {
                        "id": "Microsoft.Advisor",
                        "displayName": "Microsoft.Advisor"
                    }
                ]
            },
            "id": "/providers/Microsoft.Advisor/metadata/caller",
            "type": "Microsoft.Advisor/metadata",
            "name": "caller"
        }
    ]
}

Step 2. Use ARG Query

Use the ID to fetch impacted resources from Azure Resource Graph (ARG).

advisorresources
| where type == "microsoft.advisor/recommendations"
| where properties.recommendationTypeId == "7e570000-n78d-yh67-2xzc4-v16005e1k" //use the Id fetched from above
| extend resourceId = tolower(properties.resourceMetadata.resourceId)
| project resourceId 
| join kind=inner (
    resources
    | extend region = location, resourceId = tolower(id), resourceName = name, resourceGroup = resourceGroup, subscriptionId, resourceType = type 
) on resourceId
| project region = location, resourceId = tolower(id), resourceName = name, resourceGroup = resourceGroup, subscriptionId, resourceType = type 

Frequently Asked Questions

Question Answer
Are the Impacted resources only available for 'Active' retirement events? Yes, the Azure portal supports impacted resources only for Active Retirements and support for other advisories will be available in the future.

For more information