DeferredSpot Capacity Reservations Changes

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/CapacityReservation.tsp

@@ -26,7 +26,7 @@ model CapacityReservation
   >;
 
   /**
-   * SKU of the resource for which capacity needs be reserved. The SKU name and capacity is required to be set.  For Block capacity reservations, sku.capacity can only accept values 1, 2, 4, 8, 16, 32, 64. Currently VM Skus with the capability called 'CapacityReservationSupported' set to true are supported. When 'CapacityReservationSupported' is true, the SKU capability also specifies the 'SupportedCapacityReservationTypes', which lists the types of capacity reservations (such as Targeted or Block) that the SKU supports. Refer to List Microsoft.Compute SKUs in a region (https://docs.microsoft.com/rest/api/compute/resourceskus/list) for supported values.
+   * SKU of the resource for which capacity needs be reserved. The SKU name and capacity is required to be set.  For Block capacity reservations, sku.capacity can only accept values 1, 2, 4, 8, 16, 32, 64. Currently VM Skus with the capability called 'CapacityReservationSupported' set to true are supported. When 'CapacityReservationSupported' is true, the SKU capability also specifies the 'SupportedCapacityReservationTypes', which lists the types of capacity reservations (such as Targeted, Block, or DeferredSpot) that the SKU supports. Refer to List Microsoft.Compute SKUs in a region (https://docs.microsoft.com/rest/api/compute/resourceskus/list) for supported values.
    */
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-resource-invalid-envelope-property" "For backward compatibility"
   sku: Sku;
@@ -71,7 +71,7 @@ interface CapacityReservations {
   >;
 
   /**
-   * The operation to delete a capacity reservation. This operation is allowed only when all the associated resources are disassociated from the capacity reservation. Please refer to https://aka.ms/CapacityReservation for more details. Note: Block capacity reservations cannot be deleted after it has been successfully allocated until the schedule end time.
+   * The operation to delete a capacity reservation. This operation is allowed only when all the associated resources are disassociated from the capacity reservation. Please refer to https://aka.ms/CapacityReservation for more details. Note: Block capacity reservations cannot be deleted after being successfully allocated until the schedule end time. DeferredSpot capacity reservations can be deleted while still pending, declined, or expired, but not when confirmed.
    */
   #suppress "deprecated" "For backward compatibility"
   #suppress "@azure-tools/typespec-azure-resource-manager/arm-delete-operation-response-codes" "For backward compatibility"

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/CapacityReservationGroup_ListByResourceGroup.json

@@ -76,6 +76,28 @@
               "reservationType": "Block"
             }
           },
+          {
+            "name": "{capacityReservationGroupName}",
+            "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}",
+            "type": "Microsoft.Compute/CapacityReservationGroups",
+            "location": "West US",
+            "properties": {
+              "capacityReservations": [
+                {
+                  "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation1"
+                },
+                {
+                  "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation2"
+                }
+              ],
+              "virtualMachinesAssociated": [
+                {
+                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
+                }
+              ],
+              "reservationType": "DeferredSpot"
+            }
+          },
           {
             "name": "{capacityReservationGroupName}",
             "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}",

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/CapacityReservationGroup_ListBySubscription.json

@@ -75,6 +75,28 @@
               "reservationType": "Block"
             }
           },
+          {
+            "name": "{capacityReservationGroupName}",
+            "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}",
+            "type": "Microsoft.Compute/CapacityReservationGroups",
+            "location": "West US",
+            "properties": {
+              "capacityReservations": [
+                {
+                  "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation1"
+                },
+                {
+                  "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation2"
+                }
+              ],
+              "virtualMachinesAssociated": [
+                {
+                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
+                }
+              ],
+              "reservationType": "DeferredSpot"
+            }
+          },
           {
             "name": "{capacityReservationGroupName}",
             "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/{capacityReservationGroupName}",

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/DeferredSpotCapacityReservationGroup_CreateOrUpdate.json

@@ -0,0 +1,49 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-03-01",
+    "capacityReservationGroupName": "deferredSpotCapacityReservationGroup",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "department": "finance"
+      },
+      "zones": [],
+      "properties": {
+        "reservationType": "DeferredSpot"
+      }
+    }
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "name": "deferredSpotCapacityReservationGroup",
+        "location": "westus",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/deferredSpotCapacityReservationGroup",
+        "tags": {
+          "department": "finance"
+        },
+        "properties": {
+          "reservationType": "DeferredSpot"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "location": "westus",
+        "tags": {
+          "department": "finance",
+          "owner": "myCompany"
+        },
+        "name": "deferredSpotCapacityReservationGroup",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/deferredSpotCapacityReservationGroup",
+        "properties": {
+          "reservationType": "DeferredSpot"
+        }
+      }
+    }
+  },
+  "operationId": "CapacityReservationGroups_CreateOrUpdate",
+  "title": "Create or update a deferred spot capacity reservation group."
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/DeferredSpotCapacityReservationGroup_Get.json

@@ -0,0 +1,85 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscriptionId}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-03-01",
+    "capacityReservationGroupName": "deferredSpotCapacityReservationGroup",
+    "$expand": "instanceView"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/CapacityReservationGroups/deferredSpotCapacityReservationGroup",
+        "properties": {
+          "capacityReservations": [
+            {
+              "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation1"
+            },
+            {
+              "id": "subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation2"
+            }
+          ],
+          "instanceView": {
+            "capacityReservations": [
+              {
+                "name": "deferredSpotCapacityReservation1",
+                "utilizationInfo": {
+                  "currentCapacity": 5,
+                  "virtualMachinesAllocated": [
+                    {
+                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
+                    },
+                    {
+                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
+                    }
+                  ]
+                },
+                "reservationStateInfo": {
+                  "reservationState": "Confirmed",
+                  "activeFrom": "2026-04-01T05:00:00+00:00",
+                  "activeUntil": "2026-04-01T07:30:00+00:00"
+                },
+                "statuses": [
+                  {
+                    "code": "ProvisioningState/succeeded",
+                    "level": "Info",
+                    "displayStatus": "Provisioning succeeded"
+                  }
+                ]
+              },
+              {
+                "name": "deferredSpotCapacityReservation2",
+                "utilizationInfo": {
+                  "currentCapacity": 5,
+                  "virtualMachinesAllocated": [
+                    {
+                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
+                    },
+                    {
+                      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM4"
+                    }
+                  ]
+                },
+                "statuses": [
+                  {
+                    "code": "ProvisioningState/succeeded",
+                    "level": "Info",
+                    "displayStatus": "Provisioning succeeded"
+                  }
+                ]
+              }
+            ]
+          },
+          "reservationType": "DeferredSpot"
+        },
+        "location": "westus",
+        "tags": {
+          "{tagName}": "{tagValue}"
+        },
+        "name": "deferredSpotCapacityReservationGroup"
+      }
+    }
+  },
+  "operationId": "CapacityReservationGroups_Get",
+  "title": "Get a deferred spot capacity reservation Group."
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/DeferredSpotCapacityReservation_CreateOrUpdate.json

@@ -0,0 +1,81 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscription-id}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-03-01",
+    "parameters": {
+      "location": "westus",
+      "tags": {
+        "department": "HR"
+      },
+      "sku": {
+        "name": "Standard_D2s_v3",
+        "capacity": 1
+      },
+      "properties": {
+        "scheduleProfile": {
+          "start": "2026-04-01T00:00:00Z",
+          "end": "2026-04-02T00:00:00Z",
+          "duration": "PT2H30M"
+        }
+      },
+      "zones": []
+    },
+    "capacityReservationGroupName": "deferredSpotCapacityReservationGroup",
+    "capacityReservationName": "deferredSpotCapacityReservation"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "name": "deferredSpotCapacityReservation",
+        "location": "westus",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation",
+        "tags": {
+          "department": "HR"
+        },
+        "sku": {
+          "name": "Standard_D2s_v3",
+          "capacity": 1
+        },
+        "properties": {
+          "platformFaultDomainCount": 3,
+          "reservationId": "{GUID}",
+          "provisioningState": "Creating",
+          "scheduleProfile": {
+            "start": "2026-04-01T00:00:00+00:00",
+            "end": "2026-04-02T00:00:00+00:00",
+            "duration": "PT2H30M"
+          },
+          "provisioningTime": "2026-03-30T01:02:38.3138469+00:00"
+        }
+      }
+    },
+    "201": {
+      "body": {
+        "name": "deferredSpotCapacityReservation",
+        "location": "westus",
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation",
+        "tags": {
+          "department": "HR"
+        },
+        "sku": {
+          "name": "Standard_D2s_v3",
+          "capacity": 1
+        },
+        "properties": {
+          "platformFaultDomainCount": 3,
+          "reservationId": "{GUID}",
+          "provisioningState": "Creating",
+          "scheduleProfile": {
+            "start": "2026-04-01T00:00:00+00:00",
+            "end": "2026-04-02T00:00:00+00:00",
+            "duration": "PT2H30M"
+          },
+          "provisioningTime": "2026-03-30T01:02:38.3138469+00:00"
+        }
+      }
+    }
+  },
+  "operationId": "CapacityReservations_CreateOrUpdate",
+  "title": "Create or update a deferred spot capacity reservation."
+}

specification/compute/resource-manager/Microsoft.Compute/Compute/Compute/examples/2026-03-01/capacityReservationExamples/DeferredSpotCapacityReservation_Get.json

@@ -0,0 +1,76 @@
+{
+  "parameters": {
+    "subscriptionId": "{subscriptionId}",
+    "resourceGroupName": "myResourceGroup",
+    "api-version": "2026-03-01",
+    "capacityReservationGroupName": "deferredSpotCapacityReservationGroup",
+    "capacityReservationName": "deferredSpotCapacityReservation",
+    "$expand": "instanceView"
+  },
+  "responses": {
+    "200": {
+      "body": {
+        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/capacityReservationGroups/deferredSpotCapacityReservationGroup/capacityReservations/deferredSpotCapacityReservation",
+        "properties": {
+          "platformFaultDomainCount": 3,
+          "reservationId": "{GUID}",
+          "provisioningTime": "2026-03-30T01:02:38.3138469+00:00",
+          "virtualMachinesAssociated": [
+            {
+              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
+            },
+            {
+              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
+            },
+            {
+              "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM3"
+            }
+          ],
+          "provisioningState": "Succeeded",
+          "instanceView": {
+            "utilizationInfo": {
+              "currentCapacity": 5,
+              "virtualMachinesAllocated": [
+                {
+                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM1"
+                },
+                {
+                  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM2"
+                }
+              ]
+            },
+            "reservationStateInfo": {
+              "reservationState": "Confirmed",
+              "activeFrom": "2026-04-01T05:00:00+00:00",
+              "activeUntil": "2026-04-01T07:30:00+00:00"
+            },
+            "statuses": [
+              {
+                "code": "ProvisioningState/succeeded",
+                "level": "Info",
+                "displayStatus": "Provisioning succeeded"
+              }
+            ]
+          },
+          "scheduleProfile": {
+            "start": "2026-04-01T00:00:00+00:00",
+            "end": "2026-04-02T00:00:00+00:00",
+            "duration": "PT2H30M"
+          },
+          "timeCreated": "2026-03-30T01:02:38.3138469+00:00"
+        },
+        "location": "westus",
+        "tags": {
+          "department": "HR"
+        },
+        "sku": {
+          "name": "Standard_D2s_v3",
+          "capacity": 1
+        },
+        "name": "deferredSpotCapacityReservation"
+      }
+    }
+  },
+  "operationId": "CapacityReservations_Get",
+  "title": "Get a deferred spot capacity reservation."
+}