# 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 CommerceManagementClient Commerce API
  version: 1.0.0
extends: openapi/microsoft-azure-commerce-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: 3
- target: $.paths['/providers/Microsoft.Commerce.Admin/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Commerce Admin REST operations
      effect: read
      questions:
      - What operations does the Azure Stack Commerce Admin provider support?
      - Is there a list of available Commerce Admin API actions?
      instructions:
      - text: List the supported Commerce Admin operations.
      - text: Show every REST operation the Commerce Admin provider exposes in API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates'].get
  update:
    x-apievangelist-phrasing:
      intent: Get subscriber usage aggregates for a period
      effect: read
      questions:
      - How can I pull usage data reported by my tenants' subscriptions for a time window?
      - Can I get subscriber usage aggregated hourly or daily?
      - Is it possible to see usage for one subscriber only?
      instructions:
      - text: Get subscriber usage for subscription {subscriptionId} from {reportedStartTime} to {reportedEndTime}.
        slots:
          subscriptionId: path.subscriptionId
          reportedStartTime: query.reportedStartTime
          reportedEndTime: query.reportedEndTime
      - text: Show {aggregationGranularity} usage for subscriber {subscriberId} between {reportedStartTime} and {reportedEndTime}.
        slots:
          aggregationGranularity: query.aggregationGranularity
          subscriberId: query.subscriberId
          reportedStartTime: query.reportedStartTime
          reportedEndTime: query.reportedEndTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Commerce.Admin/updateEncryption'].post
  update:
    x-apievangelist-phrasing:
      intent: Update Commerce Admin encryption
      effect: write
      questions:
      - Can I trigger an encryption update for Commerce Admin data?
      - What does updating encryption on the Commerce Admin provider do?
      instructions:
      - text: Update the Commerce Admin encryption for subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Refresh commerce data encryption in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      method: generated
      generated: '2026-09-26'