# 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 UsageManagementClient Usage Aggregates API
  version: 1.0.0
extends: openapi/microsoft-azure-usageaggregates-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: 1
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Commerce/UsageAggregates'].get
  update:
    x-apievangelist-phrasing:
      intent: Get aggregated subscription usage for a date range
      effect: read
      questions:
      - How much Azure did my subscription consume between two dates?
      - Can I get usage broken down hourly instead of daily?
      - Is there a way to see instance-level usage detail?
      instructions:
      - text: Get usage aggregates for subscription {subscription} from {start} to {end}.
        slots:
          subscription: path.subscriptionId
          start: query.reportedStartTime
          end: query.reportedEndTime
      - text: Pull hourly usage for {subscription} between {start} and {end} with granularity {granularity}.
        slots:
          subscription: path.subscriptionId
          start: query.reportedStartTime
          end: query.reportedEndTime
          granularity: query.aggregationGranularity
      - text: Show instance-level usage for {subscription} from {start} to {end} with details {show_details}.
        slots:
          subscription: path.subscriptionId
          start: query.reportedStartTime
          end: query.reportedEndTime
          show_details: query.showDetails
      method: generated
      generated: '2026-09-26'