Recommendations - Update

Service:

Advisor

API Version:

2026-10-01

Update the state of a Recommendation

PATCH https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Advisor/recommendations/{recommendationId}?api-version=2026-10-01

URI Parameters

Name	In	Required	Type	Description
recommendationId	path	True	string	The recommendation ID.
subscriptionId	path	True	string (uuid)	The ID of the target subscription. The value must be an UUID.
api-version	query	True	string minLength: 1	The API version to use for this operation.

Request Body

Name	Type	Description
properties	RecommendationStatePropertiesPayload	The properties for recommendation patch payload.

Responses

Name	Type	Description
200 OK	ResourceRecommendationBase	Azure operation completed successfully.
Other Status Codes	ErrorResponse	An unexpected error response.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

PatchRecommendationStateProperties

Sample request

HTTP

PATCH https://management.azure.com/subscriptions/a5481ee1-95df-47d0-85d4-dd3f0dfa19bc/providers/Microsoft.Advisor/recommendations/2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b45?api-version=2026-10-01

{
  "properties": {
    "recommendationStatus": "Postponed",
    "postponedUntilDateTime": "2026-11-12T00:00:00Z"
  }
}

Sample response

Status code:

200

{
  "id": "/subscriptions/a5481ee1-95df-47d0-85d4-dd3f0dfa19bc/resourceGroups/resourceGroup/providers/Microsoft.Compute/availabilitysets/armavset/providers/Microsoft.Advisor/recommendations/2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b45",
  "name": "2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b45",
  "properties": {
    "category": "HighAvailability",
    "impact": "Medium",
    "impactedField": "Microsoft.Compute/availabilitysets",
    "impactedValue": "armavset",
    "recommendationStatus": "Postponed",
    "postponedUntilDateTime": "2026-11-12T00:00:00Z",
    "lastUpdated": "2026-10-12T00:00:00Z",
    "shortDescription": {
      "problem": "Add one or more virtual machines to this availability set to ensure high availability",
      "solution": "Add one or more virtual machines to this availability set to ensure high availability"
    },
    "resourceMetadata": {
      "resourceId": "/subscriptions/a5481ee1-95df-47d0-85d4-dd3f0dfa19bc/resourceGroups/resourceGroup/providers/Microsoft.Compute/availabilitysets/armavset"
    }
  },
  "type": "Microsoft.Advisor/recommendations"
}

Definitions

Name	Description
Category	The category of the recommendation.
Control	The sub-category of the recommendation.
createdByType	The type of identity that created the resource.
ErrorAdditionalInfo	The resource management error additional info.
ErrorDetail	The error detail.
ErrorResponse	Error response
Impact	The business impact of the recommendation.
Priority	The Priority of the Recommendation.
RecommendationDismissReason	The reason for dismissing the Recommendation.
RecommendationPatchPayload	The recommendation patch payload.
RecommendationPropertiesResourceWorkload	The Workload that this Resource belongs to.
RecommendationPropertiesReview	The Review that this Recommendation belongs to.
RecommendationStatePropertiesPayload	Properties for recommendation state patch payload.
RecommendationStatus	The state of the Recommendation applicable from v2026-02-01-preview.
ResourceMetadata	Recommendation resource metadata
ResourceRecommendationBase	Advisor Recommendation.
Risk	The potential risk of not implementing the recommendation.
ShortDescription	A summary of the recommendation.
systemData	Metadata pertaining to creation and last modification of the resource.
TrackedRecommendationProperties	The tracked properties of a Recommendation

Category

Enumeration

The category of the recommendation.

Value	Description
HighAvailability
Security
Performance
Cost
OperationalExcellence

Control

Enumeration

The sub-category of the recommendation.

Value	Description
HighAvailability
BusinessContinuity
DisasterRecovery
Scalability
MonitoringAndAlerting
ServiceUpgradeAndRetirement
Other
PrioritizedRecommendations
Personalized

createdByType

Enumeration

The type of identity that created the resource.

Value	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

ErrorDetail

Object

The error detail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	The error code.
details	ErrorDetail[]	The error details.
message	string	The error message.
target	string	The error target.

ErrorResponse

Object

Error response

Name	Type	Description
error	ErrorDetail	The error object.

Impact

Enumeration

The business impact of the recommendation.

Value	Description
High
Medium
Low

Priority

Enumeration

The Priority of the Recommendation.

Value	Description
Critical
High
Medium
Low
Informational

RecommendationDismissReason

Enumeration

The reason for dismissing the Recommendation.

Value	Description
ExcessiveCostInvestmentRequired
TooComplexOrImpracticalToImplement
AnAlternativeSolutionIsAlreadyInPlace
IncompatibleWithTheCurrentConfiguration
ImplementationStepsAreUnclear
RiskIsAcceptable
Other

RecommendationPatchPayload

Object

The recommendation patch payload.

Name	Type	Description
properties	RecommendationStatePropertiesPayload	The properties for recommendation patch payload.

RecommendationPropertiesResourceWorkload

Object

The Workload that this Resource belongs to.

Name	Type	Description
id	string	The Id of the Workload
name	string	The Name of the Workload

RecommendationPropertiesReview

Object

The Review that this Recommendation belongs to.

Name	Type	Description
id	string	The ARM Resource Id of the Review
name	string	The Name of the Review

RecommendationStatePropertiesPayload

Object

Properties for recommendation state patch payload.

Name	Type	Description
postponedUntilDateTime	string (date-time)	The time the Recommendation was postponed until.
recommendationDismissReason	RecommendationDismissReason	The reason the state of the Recommendation was changed.
recommendationStatus	RecommendationStatus	The state of the recommendation.

RecommendationStatus

Enumeration

The state of the Recommendation applicable from v2026-02-01-preview.

Value	Description
New
Postponed
Dismissed
Completed

ResourceMetadata

Object

Recommendation resource metadata

Name	Type	Description
action	management.azure.com.advisor.recommendations.update	The action to view resource.
plural	string	The plural user friendly name of resource type. eg: virtual machines
resourceId	string	Azure resource Id of the assessed resource
singular	string	The singular user friendly name of resource type. eg: virtual machine
source	string	Source from which recommendation is generated

ResourceRecommendationBase

Object

Advisor Recommendation.

Name	Type	Description
id	string (arm-id)	Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	The name of the resource
properties.actions	RecommendationProperties.Actions[]	The list of recommended actions to implement recommendation.
properties.category	Category	The category of the recommendation.
properties.completionType	string	The type of recommendation completion, which is either MarkedByUser or SystemVerified
properties.control	Control	The sub-category of the recommendation.
properties.createdTime	string (date-time)	The created time of the recommendation.
properties.description	string	The detailed description of recommendation.
properties.exposedMetadataProperties	management.azure.com.advisor.recommendations.update	The recommendation metadata properties exposed to customer to provide additional information.
properties.extendedProperties	object	Extended properties
properties.impact	Impact	The business impact of the recommendation.
properties.impactedField	string	The resource type identified by Advisor.
properties.impactedValue	string	The resource identified by Advisor.
properties.label	string	The label of recommendation.
properties.lastRefreshed	string (date-time)	The most recent time Advisor evaluated the recommendation for validity (re-ingested).
properties.lastUpdated	string (date-time)	The most recent time the recommendation state changed (manual or automated).
properties.learnMoreLink	string	The link to learn more about recommendation and generation logic.
properties.metadata	management.azure.com.advisor.recommendations.update	The recommendation metadata.
properties.notes	string	Additional notes for the Recommendation
properties.postponedUntilDateTime	string (date-time)	The time the Recommendation was postponed until.
properties.potentialBenefits	string	The potential benefit of implementing recommendation.
properties.recommendationDismissReason	RecommendationDismissReason	The reason the Recommendation was dismissed.
properties.recommendationStatus	RecommendationStatus	The state of the Recommendation
properties.recommendationTypeId	string	The recommendation-type GUID.
properties.remediation	management.azure.com.advisor.recommendations.update	The automated way to apply recommendation.
properties.resourceMetadata	ResourceMetadata	Metadata of resource that was assessed
properties.resourceWorkload	RecommendationPropertiesResourceWorkload	The Workload that this Resource belongs to.
properties.review	RecommendationPropertiesReview	The Review that this Recommendation belongs to.
properties.risk	Risk	The potential risk of not implementing the recommendation.
properties.shortDescription	ShortDescription	A summary of the recommendation.
properties.sourceSystem	string	The Source System that this Recommendation originated from.
properties.suppressionId	string	The single snoozed or dismissed rule for the recommendation.
properties.trackedProperties	TrackedRecommendationProperties	The properties of a tracked recommendation.
systemData	systemData	Azure Resource Manager metadata containing createdBy and modifiedBy information.
type	string	The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

Risk

Enumeration

The potential risk of not implementing the recommendation.

Value	Description
Error
Warning
None

ShortDescription

Object

A summary of the recommendation.

Name	Type	Description
problem	string	The issue or opportunity identified by the recommendation and proposed solution.
solution	string	The issue or opportunity identified by the recommendation and proposed solution.

systemData

Object

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string (date-time)	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string (date-time)	The timestamp of resource last modification (UTC)
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.

TrackedRecommendationProperties

Object

The tracked properties of a Recommendation

Name	Type	Description
priority	Priority	The Priority of the Recommendation.