Add swagger for CapacityBlocks API

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/ComputeDiagnosticBase.tsp

@@ -1,13 +1,11 @@
-import "@azure-tools/typespec-azure-core";
-import "@azure-tools/typespec-azure-resource-manager";
-import "@typespec/openapi";
-import "@typespec/rest";
 import "./models.tsp";
+import "@typespec/openapi";
 
-using TypeSpec.Rest;
 using Azure.ResourceManager;
 using TypeSpec.Http;
 using TypeSpec.OpenAPI;
+using TypeSpec.Rest;
+using Versioning;
 
 namespace Microsoft.Compute;
 /**
@@ -50,3 +48,57 @@ interface ComputeDiagnosticBases {
 @@doc(ComputeDiagnosticBases.post::parameters.body,
   "SpotPlacementScores object supplied in the body of the Post spot placement scores operation."
 );
+
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-interface-requires-decorator" "For backward compatibility"
+@armResourceOperations
+@added(Versions.v2025_06_05_preview)
+interface CapacityBlocksOperationGroup {
+  /**
+   * Get available capacity blocks.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "non-standard operations"
+  @operationId("CapacityBlocks_Get")
+  @autoRoute
+  @get
+  @action("capacityBlocks")
+  @list
+  list is ArmProviderActionSync<
+    Response = CapacityBlocks,
+    Scope = SubscriptionActionScope,
+    Parameters = {
+      /**
+       * An OData filter expression that describes a subset of capacity blocks to return. Mandatory parameters are sku, capacity, durationhours, start-date-range and end-date-range. Optional parameters are zone and location. The supported operator is eq. Example: $filter = sku eq Standard_D16s_v4 and capacity eq 4 and start-date-range eq 2025-06-25T00:00:00-07:00 and end-date-range eq 2025-06-27T00:00:00-07:00 and durationhours eq 24 and zone eq 1 and location eq westus
+       */
+      @query("$filter")
+      $filter: string;
+    }
+  >;
+}
+
+#suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-interface-requires-decorator" "For backward compatibility"
+@armResourceOperations
+@added(Versions.v2025_06_05_preview)
+interface RegionalCapacityBlocksOperationGroup {
+  /**
+   * Get available capacity blocks by location.
+   */
+  #suppress "@azure-tools/typespec-azure-core/no-openapi" "non-standard operations"
+  @operationId("RegionalCapacityBlocks_Get")
+  @autoRoute
+  @get
+  @action("capacityBlocks")
+  @list
+  list is ArmProviderActionSync<
+    Response = CapacityBlocks,
+    Scope = SubscriptionActionScope,
+    Parameters = {
+      ...LocationParameter;
+
+      /**
+       * An OData filter expression that describes a subset of capacity blocks to return. Mandatory parameters are sku, capacity, durationhours, start-date-range and end-date-range. Optional parameters are zone. The supported operator is eq. Example: $filter = sku eq Standard_D16s_v4 and capacity eq 4 and start-date-range eq 2025-06-25T00:00:00-07:00 and end-date-range eq 2025-06-27T00:00:00-07:00 and durationhours eq 24 and zone eq 1
+       */
+      @query("$filter")
+      $filter: string;
+    }
+  >;
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/GenerateSpotPlacementScores.json

@@ -0,0 +1,87 @@
+{
+  "operationId": "SpotPlacementScores_Post",
+  "parameters": {
+    "api-version": "2025-06-05-preview",
+    "location": "eastus",
+    "spotPlacementScoresInput": {
+      "availabilityZones": true,
+      "desiredCount": 1,
+      "desiredLocations": [
+        "eastus",
+        "eastus2"
+      ],
+      "desiredSizes": [
+        {
+          "sku": "Standard_D2_v2"
+        }
+      ]
+    },
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "title": "Returns spot VM placement scores for given configurations.",
+  "responses": {
+    "200": {
+      "body": {
+        "availabilityZones": true,
+        "desiredCount": 1,
+        "desiredLocations": [
+          "eastus",
+          "eastus2"
+        ],
+        "desiredSizes": [
+          {
+            "sku": "Standard_D2_v2"
+          }
+        ],
+        "placementScores": [
+          {
+            "availabilityZone": "1",
+            "isQuotaAvailable": true,
+            "region": "eastus",
+            "score": "High",
+            "sku": "Standard_D2_v2"
+          },
+          {
+            "availabilityZone": "2",
+            "isQuotaAvailable": true,
+            "region": "eastus",
+            "score": "High",
+            "sku": "Standard_D2_v2"
+          },
+          {
+            "availabilityZone": "3",
+            "isQuotaAvailable": true,
+            "region": "eastus",
+            "score": "High",
+            "sku": "Standard_D2_v2"
+          },
+          {
+            "availabilityZone": "1",
+            "isQuotaAvailable": true,
+            "region": "eastus2",
+            "score": "DataNotFoundOrStale",
+            "sku": "Standard_D2_v2"
+          },
+          {
+            "availabilityZone": "2",
+            "isQuotaAvailable": true,
+            "region": "eastus2",
+            "score": "High",
+            "sku": "Standard_D2_v2"
+          },
+          {
+            "availabilityZone": "3",
+            "isQuotaAvailable": true,
+            "region": "eastus2",
+            "score": "High",
+            "sku": "Standard_D2_v2"
+          }
+        ]
+      },
+      "headers": {
+        "location": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/locations/eastus/placementScores/spot/generate?api-version=2025-06-05",
+        "x-ms-request-id": "57b891ab-1fb7-4f5a-b002-71eb6854961f"
+      }
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/GetCapacityBlocks.json

@@ -0,0 +1,51 @@
+{
+  "parameters": {
+    "$filter": "sku eq Standard_D16s_v4 and capacity eq 4 and start-date-range eq 2025-07-15T00:00:00-07:00 and end-date-range eq 2025-07-21T00:00:00-07:00 and durationhours eq 24 and zone eq 1 and location eq eastus",
+    "api-version": "2025-06-05-preview",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "37522560-0aee-4258-8146-de5db0ab97bc",
+            "type": "capacityBlocks",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/capacityBlocks/37522560-0aee-4258-8146-de5db0ab97bc",
+            "properties": {
+              "location": "eastus",
+              "scheduleProfile": {
+                "end": "2025-07-17T12:00:00+00:00",
+                "start": "2025-07-16T12:00:00+00:00"
+              },
+              "sku": {
+                "name": "Standard_ND_A100_v4",
+                "capacity": 4
+              },
+              "zone": 1
+            }
+          },
+          {
+            "name": "2f8f8aea-1122-4a3b-bbdc-6535daf15dd9",
+            "type": "capacityBlocks",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/capacityBlocks/2f8f8aea-1122-4a3b-bbdc-6535daf15dd9",
+            "properties": {
+              "location": "eastus",
+              "scheduleProfile": {
+                "end": "2025-07-20T12:00:00+00:00",
+                "start": "2025-07-19T12:00:00+00:00"
+              },
+              "sku": {
+                "name": "Standard_ND_A100_v4",
+                "capacity": 4
+              },
+              "zone": 1
+            }
+          }
+        ]
+      }
+    }
+  },
+  "operationId": "CapacityBlocks_Get",
+  "title": "Returns list of capacity block objects."
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/GetCapacityBlocksByLocation.json

@@ -0,0 +1,52 @@
+{
+  "parameters": {
+    "$filter": "sku eq Standard_D16s_v4 and capacity eq 4 and start-date-range eq 2025-07-15T00:00:00-07:00 and end-date-range eq 2025-07-21T00:00:00-07:00 and durationhours eq 24 and zone eq 1",
+    "api-version": "2025-06-05-preview",
+    "location": "eastus",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "37522560-0aee-4258-8146-de5db0ab97bc",
+            "type": "capacityBlocks",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/capacityBlocks/37522560-0aee-4258-8146-de5db0ab97bc",
+            "properties": {
+              "location": "eastus",
+              "scheduleProfile": {
+                "end": "2025-07-17T12:00:00+00:00",
+                "start": "2025-07-16T12:00:00+00:00"
+              },
+              "sku": {
+                "name": "Standard_ND_A100_v4",
+                "capacity": 4
+              },
+              "zone": 1
+            }
+          },
+          {
+            "name": "2f8f8aea-1122-4a3b-bbdc-6535daf15dd9",
+            "type": "capacityBlocks",
+            "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/capacityBlocks/2f8f8aea-1122-4a3b-bbdc-6535daf15dd9",
+            "properties": {
+              "location": "eastus",
+              "scheduleProfile": {
+                "end": "2025-07-20T12:00:00+00:00",
+                "start": "2025-07-19T12:00:00+00:00"
+              },
+              "sku": {
+                "name": "Standard_ND_A100_v4",
+                "capacity": 4
+              },
+              "zone": 1
+            }
+          }
+        ]
+      }
+    }
+  },
+  "operationId": "RegionalCapacityBlocks_Get",
+  "title": "Returns list of capacity block objects."
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/GetSpotPlacementScores.json

@@ -0,0 +1,26 @@
+{
+  "operationId": "SpotPlacementScores_Get",
+  "parameters": {
+    "api-version": "2025-06-05-preview",
+    "location": "eastus",
+    "subscriptionId": "00000000-0000-0000-0000-000000000000"
+  },
+  "title": "Gets the metadata of Spot Placement Scores.",
+  "responses": {
+    "200": {
+      "body": {
+        "name": "spotPlacementScores",
+        "type": "Microsoft.Compute/placementScores",
+        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Compute/placementScores/spot?api-version=2025-06-05",
+        "properties": {
+          "supportedResourceTypes": [
+            "Microsoft.Compute/virtualMachines"
+          ]
+        }
+      },
+      "headers": {
+        "x-ms-request-id": "27b7c568-16ec-46f3-bcf1-5bea3f2529b1"
+      }
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/Operations_List_MaximumSet_Gen.json

@@ -0,0 +1,25 @@
+{
+  "operationId": "Operations_List",
+  "parameters": {
+    "api-version": "2025-06-05-preview"
+  },
+  "title": "Operations_List_MaximumSet_Gen",
+  "responses": {
+    "200": {
+      "body": {
+        "value": [
+          {
+            "name": "aaaaaaaaaaaa",
+            "display": {
+              "description": "aaaaaaaaaaaaaaaaaaaaaa",
+              "operation": "aaaaaaaaaaaaaaaaaaaaaa",
+              "provider": "aaaaaaaaaaaaaaaaaa",
+              "resource": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+            },
+            "origin": "aaaaa"
+          }
+        ]
+      }
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/examples/2025-06-05-preview/Operations_List_MinimumSet_Gen.json

@@ -0,0 +1,12 @@
+{
+  "operationId": "Operations_List",
+  "parameters": {
+    "api-version": "2025-06-05-preview"
+  },
+  "title": "Operations_List_MinimumSet_Gen",
+  "responses": {
+    "200": {
+      "body": {}
+    }
+  }
+}

specification/compute/resource-manager/Microsoft.Compute/RecommenderRP/main.tsp

@@ -39,4 +39,9 @@ enum Versions {
    * The 2025-06-05 API version.
    */
   v2025_06_05: "2025-06-05",
+
+  /**
+   * The 2025-06-05-preview API version.
+   */
+  v2025_06_05_preview: "2025-06-05-preview",
 }