Advisor : Adding 2026-02-preview version

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/ResourceRecommendationBase.tsp

@@ -4,6 +4,7 @@ import "./models.tsp";
 
 using Azure.ResourceManager;
 using TypeSpec.Http;
+using TypeSpec.Versioning;
 
 namespace Microsoft.Advisor;
 /**
@@ -38,6 +39,8 @@ interface ResourceRecommendationBases {
    * Update the tracked properties of a Recommendation.
    */
   #suppress "@azure-tools/typespec-azure-core/response-schema-problem" "FIXME: Update justification, follow aka.ms/tsp/conversion-fix for details"
+  @added(Versions.v2025_05_01_preview)
+  @removed(Versions.v2026_02_01_preview)
   @patch(#{ implicitOptionality: false })
   patch is ArmCustomPatchSync<
     ResourceRecommendationBase,
@@ -46,6 +49,15 @@ interface ResourceRecommendationBases {
     Error = ArmDefaultErrorResponse
   >;
 
+  /** Update the state of a Recommendation */
+  @added(Versions.v2026_02_01_preview)
+  @patch(#{ implicitOptionality: false })
+  update is Extension.CustomPatchSync<
+    Extension.Subscription,
+    ResourceRecommendationBase,
+    RecommendationPatchPayload
+  >;
+
   /**
    * Obtains cached recommendations for a subscription. The recommendations are generated or computed by invoking generateRecommendations.
    */
@@ -55,7 +67,11 @@ interface ResourceRecommendationBases {
     BaseParameters = Azure.ResourceManager.Foundations.SubscriptionBaseParameters,
     Parameters = {
       /**
-       * The filter to apply to the recommendations.<br>Filter can be applied to properties ['ResourceId', 'ResourceGroup', 'RecommendationTypeGuid', '[Category](#category)'] with operators ['eq', 'and', 'or'].<br>Example:<br>- $filter=Category eq 'Cost' and ResourceGroup eq 'MyResourceGroup'
+       * The filter to apply to the recommendations.<br>Filter can be applied to properties ['ResourceId', 'ResourceGroup', 'RecommendationTypeGuid', '[Category](#category)', 'SubCategory', 'RetirementDate', '[Status](#recommendationStatus)'] with operators ['eq', 'and', 'or', 'lt', 'gt', 'le', 'ge']<br>.
+       * <br>**Note:** `Control` is a legacy filter property and will be deprecated in the future. Please use `SubCategory` for filtering recommendation subcategory.<br>
+       * <br>**Note:** `Status` filter is available from API Version 2026-02-01-preview and onwards.<br>
+       * <br>Valid options for SubCategory:<br>['BusinessContinuity', 'DisasterRecovery', 'HighAvailability', 'MonitoringAndAlerting', 'Other', 'Personalized', 'PrioritizedRecommendations', 'Scalability', 'ServiceUpgradeAndRetirement', 'Validation']<br>
+       * <br>Example:<br>- $filter=Category eq 'Cost' and ResourceGroup eq 'MyResourceGroup'<br>-$filter=SubCategory eq 'ServiceUpgradeAndRetirement' and RetirementDate le '2024-01-01' and RetirementDate ge '2028-01-01'
        */
       @query("$filter")
       $filter?: string;

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/CreateConfiguration.json

@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "58c3f667-7a62-4bfd-a658-846493e9a493",
+    "resourceGroup": "resourceGroup",
+    "configurationName": "default",
+    "configContract": {
+      "properties": {
+        "lowCpuThreshold": "5",
+        "duration": "7",
+        "exclude": true,
+        "digests": [
+          {
+            "name": "digestConfigName",
+            "actionGroupResourceId": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/microsoft.insights/actionGroups/actionGroupName",
+            "frequency": 30,
+            "categories": [
+              "HighAvailability",
+              "Security",
+              "Performance",
+              "Cost",
+              "OperationalExcellence"
+            ],
+            "language": "en",
+            "state": "Active"
+          }
+        ]
+      }
+    },
+    "api-version": "2026-02-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default",
+        "type": "Microsoft.Advisor/configurations",
+        "name": "default",
+        "properties": {
+          "lowCpuThreshold": "5",
+          "duration": "7",
+          "exclude": true,
+          "digests": [
+            {
+              "name": "digestConfigName",
+              "actionGroupResourceId": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/microsoft.insights/actionGroups/actionGroupName",
+              "frequency": 30,
+              "categories": [
+                "HighAvailability",
+                "Security",
+                "Performance",
+                "Cost",
+                "OperationalExcellence"
+              ],
+              "language": "en",
+              "state": "Active"
+            }
+          ]
+        }
+      }
+    }
+  },
+  "operationId": "Configurations_CreateInResourceGroup",
+  "title": "PutConfigurations"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/CreateConfiguration_CreateInSubscription.json

@@ -0,0 +1,63 @@
+{
+  "parameters": {
+    "subscriptionId": "58c3f667-7a62-4bfd-a658-846493e9a493",
+    "resourceGroup": "resourceGroup",
+    "configurationName": "default",
+    "configContract": {
+      "properties": {
+        "lowCpuThreshold": "5",
+        "duration": "7",
+        "exclude": true,
+        "digests": [
+          {
+            "name": "digestConfigName",
+            "actionGroupResourceId": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/microsoft.insights/actionGroups/actionGroupName",
+            "frequency": 30,
+            "categories": [
+              "HighAvailability",
+              "Security",
+              "Performance",
+              "Cost",
+              "OperationalExcellence"
+            ],
+            "language": "en",
+            "state": "Active"
+          }
+        ]
+      }
+    },
+    "api-version": "2026-02-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/Microsoft.Advisor/configurations/default",
+        "type": "Microsoft.Advisor/configurations",
+        "name": "default",
+        "properties": {
+          "lowCpuThreshold": "5",
+          "duration": "7",
+          "exclude": true,
+          "digests": [
+            {
+              "name": "digestConfigName",
+              "actionGroupResourceId": "/subscriptions/58c3f667-7a62-4bfd-a658-846493e9a493/resourceGroups/resourceGroup/providers/microsoft.insights/actionGroups/actionGroupName",
+              "frequency": 30,
+              "categories": [
+                "HighAvailability",
+                "Security",
+                "Performance",
+                "Cost",
+                "OperationalExcellence"
+              ],
+              "language": "en",
+              "state": "Active"
+            }
+          ]
+        }
+      }
+    }
+  },
+  "operationId": "Configurations_CreateInSubscription",
+  "title": "PutConfigurations"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/CreateSuppression.json

@@ -0,0 +1,36 @@
+{
+  "parameters": {
+    "resourceUri": "resourceUri",
+    "recommendationId": "2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b36",
+    "name": "2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b45",
+    "suppressionContract": {
+      "properties": {
+        "ttl": "07:00:00:00"
+      }
+    },
+    "api-version": "2026-02-01-preview"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/a5481ee1-95df-47d0-85d4-dd3f0dfa19bc/resourceGroups/resourceGroup/providers/Microsoft.Compute/availabilitysets/armavset/providers/Microsoft.Advisor/recommendations/2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b36/suppressions/HardcodedSuppressionName",
+        "name": "HardcodedSuppressionName",
+        "type": "Microsoft.Advisor/suppressions",
+        "properties": {
+          "suppressionId": "2e7c72b2d7987ec224a1ebae03398b0fbdaa9a5a6a762e6fcf1c806599744b45",
+          "ttl": "07:00:00:00"
+        }
+      }
+    },
+    "404": {
+      "body": {
+        "error": {
+          "code": "NotFound",
+          "message": "Recommendation to be suppressed is not found. Subscription Id:{0} Recommendation Id:{1}"
+        }
+      }
+    }
+  },
+  "operationId": "Suppressions_Create",
+  "title": "CreateSuppression"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/DeleteAssessment.json

@@ -0,0 +1,15 @@
+{
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "assessmentName": "assessment1",
+    "subscriptionId": "00000000-1111-2222-3333-444444444444"
+  },
+  "responses": {
+    "200": {},
+    "204": {
+      "description": "The Assessment is not found or has been deleted already."
+    }
+  },
+  "operationId": "Assessments_Delete",
+  "title": "DeleteAssessment"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/DeleteSuppression.json

@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "name": "HardcodedSuppressionName",
+    "api-version": "2026-02-01-preview",
+    "recommendationId": "recommendationId",
+    "resourceUri": "resourceUri"
+  },
+  "responses": {
+    "204": {}
+  },
+  "operationId": "Suppressions_Delete",
+  "title": "DeleteSuppression"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/EmptyResponse.json

@@ -0,0 +1,13 @@
+{
+  "parameters": {
+    "operationId": "123e4567-e89b-12d3-a456-426614174000",
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "12345678-1234-1234-1234-123456789012"
+  },
+  "responses": {
+    "202": {},
+    "204": {}
+  },
+  "operationId": "Recommendations_GetGenerateStatus",
+  "title": "GetGenerateStatus"
+}

specification/advisor/resource-manager/Microsoft.Advisor/Advisor/examples/2026-02-01-preview/GenerateRecommendations.json

@@ -0,0 +1,16 @@
+{
+  "parameters": {
+    "api-version": "2026-02-01-preview",
+    "subscriptionId": "12345678-1234-1234-1234-123456789012"
+  },
+  "responses": {
+    "202": {
+      "headers": {
+        "Location": "https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.Microsoft.Advisor/generateRecommendations/recGUID?api-version=2026-02-01-preview",
+        "Retry-After": "60"
+      }
+    }
+  },
+  "operationId": "Recommendations_Generate",
+  "title": "GenerateRecommendations"
+}