# 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 Usage Details…
  version: 1.0.0
extends: openapi/microsoft-azure-usagedetails-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: 2
- target: $.paths['/{scope}/providers/Microsoft.Consumption/usageDetails'].get
  update:
    x-apievangelist-phrasing:
      intent: List usage details for a billing scope
      effect: read
      questions:
      - What Azure usage and charges were recorded for my subscription or billing account?
      - Can I choose between actual and amortized cost when listing usage details?
      - How far back does usage detail data go?
      instructions:
      - text: List usage details for scope {scope}.
        slots:
          scope: path.scope
      - text: Show usage details for {scope} matching {filter} using the {metric} cost metric.
        slots:
          scope: path.scope
          filter: query.$filter
          metric: query.metric
      - text: Get the top {top} usage records for {scope}.
        slots:
          top: query.$top
          scope: path.scope
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{scope}/providers/Microsoft.Consumption/usageDetails/download'].post
  update:
    x-apievangelist-phrasing:
      intent: Download usage details as a file
      effect: read
      questions:
      - Can I export my Azure usage details to a downloadable file instead of paging the API?
      - How do I get a bulk usage file for a billing scope?
      instructions:
      - text: Download usage details data for scope {scope}.
        slots:
          scope: path.scope
      - text: Generate a usage file for {scope} with the {metric} metric.
        slots:
          scope: path.scope
          metric: query.metric
      method: generated
      generated: '2026-09-26'