Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.
They're shown in the 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
Export to a CSV file
Select the Export to CSV to export the list of impacted resources to an Excel 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. |