[Compute] Surface VMSS VM capacity reservation details

[Priyal-Saxena]

Preconditions

• No need to upgrade Python SDK or the Python SDK is ready.

Related command

az vmss show --resource-group <resource-group> --name <vmss-name> --instance-id <instance-id>
  (surface capacityReservation.capacityReservationGroup.id)

az vmss get-instance-view --resource-group <resource-group> --name <vmss-name> --instance-id <instance-id>
  (surface capacityReservationType)

Resource Provider

Microsoft.Compute/virtualMachineScaleSets/virtualMachines

Description of Feature or Work Requested

Add Azure CLI output support for two VM Scale Set VM capacity reservation properties introduced in Compute API version 2026-04-01:

• capacityReservation on the VMSS VM model-view response. This exposes the capacity reservation group inherited from the parent VM scale set.
• capacityReservationType on the VMSS VM instance-view response. This indicates whether the instance consumes Targeted, Open, or Block reserved capacity, is NotEligible, or is explicitly Disabled.

Both properties are service-returned outputs. No new CLI input parameters or command syntax are requested.

This extends the Open Capacity Reservation work tracked in #33769 to VMSS VM responses.

Minimum API Version Required

2026-04-01

Swagger PR link / SDK link

• Compute 2026-04-01: add capacityReservation to VirtualMachineScaleSetVM response azure-rest-api-specs#44684
• Compute 2026-04-01: add capacityReservationType to VMSS VM instance view azure-rest-api-specs#44682

Request Example

• VMSS VM model view with capacity reservation:
  https://github.com/Azure/azure-rest-api-specs/blob/compute-2026-04-01/specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2026-04-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetVM_Get_WithCapacityReservation.json
• VMSS VM instance view with capacity reservation type:
  https://github.com/Azure/azure-rest-api-specs/blob/compute-2026-04-01/specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2026-04-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetVM_Get_InstanceViewWithCapacityReservationType.json

Target Date

2026-08-15

PM Contact

N/A / TBD

Engineer Contact

Priyal Saxena (Priyal Saxena (@Priyal-Saxena))

Additional context

The REST API specification changes are merged. SDK generation and publication are handled through the standard Compute SDK release process.

[yonzhan]

Thank you for opening this issue, we will look into it.