Azure reservation names
Group and filter your Azure spend by the reservation names you see in the Azure portal, so your reservation costs in CloudZero match what Microsoft shows you. CloudZero adds each reservation's name to its cost rows, and you choose how to group by it with a custom category (called a Dimension).
Reservation properties
Each Azure cost row that Azure reports under a reservation carries two line-item properties:
| Property | Description | Example |
|---|---|---|
azure:reservation_name | The reservation's name as it appears in the Azure portal | prod-vm-reservation |
azure:reservation_label | The name followed by the first 8 characters of the reservation ID, or of the order ID on purchase, fee, and refund rows | prod-vm-reservation (1a2b3c4d) |
Azure doesn't require reservation names to be unique, so two reservations can share a name. The label tells them apart.
Purchase, fee, and refund rows identify the reservation order rather than the reservation, so their label uses the first 8 characters of the order ID instead: prod-vm-reservation (order 5e6f7a8b).
On-demand and savings plan rows carry neither property.
Group costs by reservation
Line-item properties are separate from tags and do not appear as Dimensions on their own. To group or filter by reservation, add a custom Dimension in CostFormation. The Properties source holds a cost row's line-item properties, and the Dimension extracts the reservation from it with a Lookup transform:
AzureReservation:
Name: Azure Reservation
Rules:
- Type: GroupBy
Source: Properties
Transforms:
- Type: Lookup
Key: azure:reservation_nameUse Key here, because Path treats the colon in azure:reservation_name as a separator. For where to add the YAML, see Allocate through YAML with CostFormation.
Choose name or label
| Use | When | Result |
|---|---|---|
Key: azure:reservation_name | Each of your reservations has a different name | One value per reservation, matching the Azure portal, with purchases and usage together |
Key: azure:reservation_label | Two or more reservations share a name, or you can't rule it out | A separate value for each reservation's usage, even when names repeat, and a separate order value for its purchase and fee rows |
If you group by name and two reservations share it, their costs combine under that one name.
Costs not covered by a reservation appear under Not In Dimension.
Reservation costs by Cost Type
Which value a reservation's cost appears under depends on the Cost Type:
- Amortized Cost, Discounted Amortized Cost, and Real Cost (the default) spread purchase and fee charges across the usage they covered, so the cost appears under the reservation's label. Real Cost also leaves out unused reservation hours.
- Billed Cost shows purchases and fees as charged, so the cost appears under the order label, such as
prod-vm-reservation (order 5e6f7a8b), and the reservation's own label shows no cost.
If you group by azure:reservation_name, both appear under the same name. Grouping by azure:reservation_label keeps them apart, because the label carries a different ID on each: the reservation's on usage rows, the order's on purchase and fee rows.
What to expect
Reservation properties are available for November 2026 onward.
Have questions or feedback? Reach out to your account manager.
Updated 3 days ago

