# 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 BillingManagementClient Billing Periods API
  version: 1.0.0
extends: openapi/microsoft-azure-billing-periods-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods'].get
  update:
    x-apievangelist-phrasing:
      intent: List billing periods for a subscription
      effect: read
      questions:
      - What billing periods are available for my Azure subscription, newest first?
      - Does listing billing periods work for subscriptions not bought through the Azure portal?
      instructions:
      - text: List the billing periods for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show the last {top} billing periods of subscription {subscriptionId}.
        slots:
          top: query.$top
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a named billing period
      effect: read
      questions:
      - How do I look up the start and end dates of a specific billing period?
      - Can I fetch one billing period by its name?
      instructions:
      - text: Get billing period {billingPeriodName} for subscription {subscriptionId}.
        slots:
          billingPeriodName: path.billingPeriodName
          subscriptionId: path.subscriptionId
      - text: Show the dates of billing period {billingPeriodName}.
        slots:
          billingPeriodName: path.billingPeriodName
      method: generated
      generated: '2026-10-01'