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:

PropertyDescriptionExample
azure:reservation_nameThe reservation's name as it appears in the Azure portalprod-vm-reservation
azure:reservation_labelThe name followed by the first 8 characters of the reservation ID, or of the order ID on purchase, fee, and refund rowsprod-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_name

Use 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

UseWhenResult
Key: azure:reservation_nameEach of your reservations has a different nameOne value per reservation, matching the Azure portal, with purchases and usage together
Key: azure:reservation_labelTwo or more reservations share a name, or you can't rule it outA 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.


Did this page help you?