Add projectedUsage field and PrePurchasePlan example for ReservationRecommendationDetails

Author: Madhumitha Raveendar (from Dev Box)

specification/consumption/resource-manager/Microsoft.Consumption/Consumption/models.tsp

@@ -1449,6 +1449,13 @@ model ReservationRecommendationDetailsProperties {
   @added(Versions.v2026_06_01)
   @visibility(Lifecycle.Read)
   tenantId?: string;
+
+  /**
+   * Projected usage details used for generating the recommendation.
+   */
+  @added(Versions.v2026_06_01)
+  @visibility(Lifecycle.Read)
+  projectedUsage?: ReservationRecommendationDetailsProjectedUsage;
 }
 
 /**
@@ -1614,6 +1621,19 @@ model ReservationRecommendationDetailsUsageProperties {
   usageGrain?: string;
 }
 
+/**
+ * Details about projected usage data that has been used for computing the recommendation.
+ */
+@added(Versions.v2026_06_01)
+model ReservationRecommendationDetailsProjectedUsage {
+  /**
+   * Total projected retail usage in commitment units (CUs).
+   */
+  #suppress "@azure-tools/typespec-azure-core/casing-style" "CUs is an accepted abbreviation for Commitment Units"
+  @visibility(Lifecycle.Read)
+  totalRetailUsageInCUs?: float32;
+}
+
 /**
  * Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message.
  *

specification/consumption/resource-manager/Microsoft.Consumption/Consumption/stable/2026-06-01/examples/ReservationRecommendationDetailsByManagementGroup.json

@@ -17,7 +17,6 @@
         "properties": {
           "currency": "USD",
           "managementGroupId": "/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000",
-          "tenantId": "00000000-0000-0000-0000-000000000000",
           "resource": {
             "appliedScopes": [
               "00000000-0000-0000-0000-000000000000"

specification/consumption/resource-manager/Microsoft.Consumption/Consumption/stable/2026-06-01/examples/ReservationRecommendationDetailsPrePurchasePlanBySubscription.json

@@ -0,0 +1,75 @@
+{
+  "parameters": {
+    "api-version": "2026-06-01",
+    "lookBackPeriod": "Last30Days",
+    "product": "Standard_DS13_v2",
+    "region": "westus",
+    "resourceScope": "subscriptions/00000000-0000-0000-0000-000000000000",
+    "scope": "Single",
+    "term": "P3Y"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "reservationRecommendationDetails",
+        "type": "Microsoft.Consumption/ReservationRecommendationDetails",
+        "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/reservationrecommendationdetails",
+        "properties": {
+          "currency": "USD",
+          "resource": {
+            "appliedScopes": [
+              "00000000-0000-0000-0000-000000000000"
+            ],
+            "onDemandRate": 0.519,
+            "product": "Standard_DS13_v2",
+            "region": "westus",
+            "reservationRate": 0.302549467275493,
+            "resourceType": "virtualmachines"
+          },
+          "resourceGroup": null,
+          "savings": {
+            "calculatedSavings": [
+              {
+                "onDemandCost": 368.4813602070006,
+                "overageCost": 0,
+                "quantity": 2,
+                "reservationCost": 429.01514459665,
+                "savings": -60.5337843896494,
+                "totalReservationCost": 429.01514459665
+              },
+              {
+                "onDemandCost": 368.481360207,
+                "overageCost": 1.557,
+                "quantity": 1,
+                "reservationCost": 214.507572298325,
+                "savings": 152.416787908675,
+                "totalReservationCost": 216.064572298325
+              }
+            ],
+            "lookBackPeriod": 30,
+            "recommendedQuantity": 1,
+            "reservationOrderTerm": "P3Y",
+            "savingsType": "instance",
+            "unitOfMeasure": "hour"
+          },
+          "scope": "Single",
+          "usage": {
+            "firstConsumptionDate": "2026-02-03T00:00:00",
+            "lastConsumptionDate": "2026-03-03T13:00:00",
+            "lookBackUnitType": "virtualMachine quantity",
+            "usageData": [
+              340
+            ],
+            "usageGrain": "lookbackPeriod"
+          },
+          "projectedUsage": {
+            "totalRetailUsageInCUs": 350
+          }
+        }
+      }
+    },
+    "204": {}
+  },
+  "operationId": "ReservationRecommendationDetails_Get",
+  "title": "ReservationRecommendationDetailsPrePurchasePlanBySubscription"
+}

specification/consumption/resource-manager/Microsoft.Consumption/Consumption/stable/2026-06-01/examples/ReservationRecommendationsByManagementGroup.json

@@ -20,7 +20,6 @@
               "lastUsageDate": "2026-03-10T00:00:00Z",
               "lookBackPeriod": "Last7Days",
               "managementGroupId": "/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000",
-              "tenantId": "00000000-0000-0000-0000-000000000000",
               "meterId": "00000000-0000-0000-0000-000000000000",
               "netSavings": 4.634521202630137,
               "recommendedQuantity": 1,
@@ -46,7 +45,6 @@
               "lastUsageDate": "2026-03-15T00:00:00Z",
               "lookBackPeriod": 7,
               "managementGroupId": "/providers/Microsoft.Management/managementGroups/00000000-0000-0000-0000-000000000000",
-              "tenantId": "00000000-0000-0000-0000-000000000000",
               "meterId": "00000000-0000-0000-0000-000000000000",
               "netSavings": {
                 "currency": "USD",

specification/consumption/resource-manager/Microsoft.Consumption/Consumption/stable/2026-06-01/openapi.json

@@ -6075,6 +6075,18 @@
         }
       ]
     },
+    "ReservationRecommendationDetailsProjectedUsage": {
+      "type": "object",
+      "description": "Details about projected usage data that has been used for computing the recommendation.",
+      "properties": {
+        "totalRetailUsageInCUs": {
+          "type": "number",
+          "format": "float",
+          "description": "Total projected retail usage in commitment units (CUs).",
+          "readOnly": true
+        }
+      }
+    },
     "ReservationRecommendationDetailsProperties": {
       "type": "object",
       "description": "The properties of the reservation recommendation.",
@@ -6118,6 +6130,11 @@
           "type": "string",
           "description": "The tenant ID associated with the management group. Populated only when managementGroupId is populated.",
           "readOnly": true
+        },
+        "projectedUsage": {
+          "$ref": "#/definitions/ReservationRecommendationDetailsProjectedUsage",
+          "description": "Projected usage details used for generating the recommendation.",
+          "readOnly": true
         }
       }
     },