[Compute] Add Support for Future Capacity Reservation (FCR)

[AEst2002]

Preconditions

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

Related command

• az capacity reservation create --schedule-profile-start {DateTime} --minimumCommitmentDays {int} (both as optional params; both should appear on show even without --instance-view)
• az capacity reservation show --instance-view (surfaces reservationStateInfo and its constituent reservationState via instanceView.reservationStateInfo)

Resource Provider

Microsoft.Compute/capacityReservationGroups/capacityReservations

Description of Feature or Work Requested

[Private Preview]
Add Azure CLI support for the Future Capacity Reservation (FCR) feature introduced in Compute API version 2026-04-01. FCRs allow customers to create future-dated reservations by specifying a start date in order to guarantee capacity availability beginning on that date. These reservations can be created under capacity reservation groups with the existing reservation type 'Targeted' or 'Open', and undergo review before being approved in order to guarantee capacity. Once Azure has committed to fulfilling the reservation after review, customers cannot edit the schedule of, or delete, the reservation until a specified number of days has passed.

Adds a new --schedule-profile-start and -minimumCommitmentDays input on az capacity reservation create and surfaces new read-only property reservationStateInfo and reservationStateInfo.reservationState on the capacity reservation instance view. See https://aka.ms/CapacityReservation.

Minimum API Version Required

2026-04-01

Swagger PR link / SDK link

The changes in this PR are present in the main branch: Azure/azure-rest-api-specs#44621

Request Example

• https://github.com/Azure/azure-rest-api-specs/blob/main/specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2026-04-01/examples/capacityReservationExamples/FutureCapacityReservation_CreateOrUpdate.json
• https://github.com/Azure/azure-rest-api-specs/blob/main/specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2026-04-01/examples/capacityReservationExamples/FutureCapacityReservation_Get.json
• https://github.com/Azure/azure-rest-api-specs/blob/main/specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2026-04-01/examples/capacityReservationExamples/FutureCapacityReservation_ListByReservationGroup.json

Target Date

8/28/2026

PM Contact

tferdous@microsoft.com

Engineer Contact

aestevez@microsoft.com; sgovindaraju@microsoft.com

Additional context

Feature should be in private preview.

[yonzhan]

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