Skip to content

[Compute] Add Open Capacity Reservation (OCR) support #33769

Description

@btyu1

Preconditions

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

Related command

az vm create / az vm update --disable-capacity-reservation-assignment
az capacity reservation group create / update --reservation-type Open
az vm get-instance-view (surfaces capacityReservationType)
az capacity reservation show --instance-view (surfaces usedReservedCountBySubscription via instanceView.utilizationInfo)

Resource Provider

Microsoft.Compute/virtualMachines, Microsoft.Compute/capacityReservationGroups

Description of Feature or Work Requested

Add Azure CLI support for the Open Capacity Reservation (OCR) feature introduced in Compute api-version 2026-04-01. OCR lets a VM implicitly consume capacity from a matching capacity reservation group (matching VM size and zone) without explicitly associating it, and lets a VM explicitly opt out of any capacity reservation. Adds a new  --disable-capacity-reservation-assignment  input on  az vm create / az vm update , a new  Open  value for the capacity reservation group  --reservation-type , and surfaces two new read-only outputs:  capacityReservationType  on the VM instance view and  usedReservedCountBySubscription  on capacity reservation utilization (via instance view). See https://aka.ms/CapacityReservation.

Minimum API Version Required

2026-04-01

Swagger PR link / SDK link

Azure/azure-rest-api-specs#44376

Request Example

Azure/azure-rest-api-specs#44376
•  .../Compute/stable/2026-04-01/examples/virtualMachineExamples/VirtualMachine_Create_WithCapacityReservationAssignmentDisabled.json 
•  .../Compute/stable/2026-04-01/examples/capacityReservationExamples/OpenCapacityReservationGroup_CreateOrUpdate.json 
•  .../Compute/stable/2026-04-01/examples/capacityReservationExamples/OpenCapacityReservation_Get.json 
•  .../Compute/stable/2026-04-01/examples/virtualMachineExamples/VirtualMachine_Get_InstanceView.json 

Target Date

8/15/2026

PM Contact

tferdous@microsoft.com

Engineer Contact

btyutyunik@microsoft.com

Additional context

No response

Metadata

Metadata

Assignees

Labels

Auto-AssignAuto assign by botAzure CLI TeamThe command of the issue is owned by Azure CLI teamComputeaz vm/vmss/image/disk/snapshotact-observability-squadcustomer-reportedIssues that are reported by GitHub users external to the Azure organization.feature-request

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions