# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure ConsumptionManagementClient Reserved…
  version: 1.0.0
extends: openapi/microsoft-azure-reservedinstances-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/providers/Microsoft.Capacity/reservationorders/{reservationOrderId}/providers/Microsoft.Consumption/reservationSummaries'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize usage for a reservation order
      effect: read
      questions:
      - How well is my reserved instance order being used day by day or month by month?
      - Can I get monthly utilization summaries for a whole reservation order?
      instructions:
      - text: Show {grain} usage summaries for reservation order {order}.
        slots:
          grain: query.grain
          order: path.reservationOrderId
      - text: Summarize reservation order {order} utilization at {grain} grain filtered by {filter}.
        slots:
          order: path.reservationOrderId
          grain: query.grain
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Capacity/reservationorders/{reservationOrderId}/reservations/{reservationId}/providers/Microsoft.Consumption/reservationSummaries'].get
  update:
    x-apievangelist-phrasing:
      intent: Summarize usage for a single reservation
      effect: read
      questions:
      - What is the daily utilization of one reservation inside an order?
      - Can I see monthly usage summaries for a specific reserved instance?
      instructions:
      - text: For just reservation {reservation} within order {order}, give me {grain} utilization summaries.
        slots:
          grain: query.grain
          reservation: path.reservationId
          order: path.reservationOrderId
      - text: Summarize utilization of reservation {reservation} at {grain} grain.
        slots:
          reservation: path.reservationId
          grain: query.grain
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Capacity/reservationorders/{reservationOrderId}/providers/Microsoft.Consumption/reservationDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: Get usage details for a reservation order
      effect: read
      questions:
      - Which resources consumed my reservation order over a date range?
      - Can I pull detailed reserved instance usage records for an order between two dates?
      instructions:
      - text: List usage details for reservation order {order} with date filter {filter}.
        slots:
          order: path.reservationOrderId
          filter: query.$filter
      - text: Show detailed consumption of order {order} for range {filter}.
        slots:
          order: path.reservationOrderId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Capacity/reservationorders/{reservationOrderId}/reservations/{reservationId}/providers/Microsoft.Consumption/reservationDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: Get usage details for a single reservation
      effect: read
      questions:
      - Which VMs used one specific reservation during a date range?
      - Can I get per-resource usage details for a single reserved instance?
      instructions:
      - text: Break down which resources used only reservation {reservation} of order {order} over dates {filter}.
        slots:
          reservation: path.reservationId
          order: path.reservationOrderId
          filter: query.$filter
      - text: Show detailed consumption of reservation {reservation} for range {filter}.
        slots:
          reservation: path.reservationId
          filter: query.$filter
      method: generated
      generated: '2026-09-26'