# 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 Metrics Advisor Metric API
  version: 1.0.0
extends: openapi/microsoft-azure-metric-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: 5
- target: $.paths['/metrics/{metricId}/data/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Query a metric's time series data
      effect: read
      questions:
      - How do I pull the data points of a Metrics Advisor metric for a time range?
      - Can I query data for specific series of a metric?
      instructions:
      - text: Query data for metric {metricId} from {startTime} to {endTime} for series {series}.
        slots:
          metricId: path.metricId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          series: requestBody.series
      - text: Get time series values of metric {metricId} between {startTime} and {endTime}.
        slots:
          metricId: path.metricId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/metrics/{metricId}/series/query'].post
  update:
    x-apievangelist-phrasing:
      intent: List series definitions of a metric
      effect: read
      questions:
      - Which series definitions does a Metrics Advisor metric have?
      - Can I filter a metric's series by dimension values?
      instructions:
      - text: List series definitions for metric {metricId} active since {activeSince}.
        slots:
          metricId: path.metricId
          activeSince: requestBody.activeSince
      - text: Show metric {metricId} series that match dimension filter {dimensionFilter}, active since {activeSince}.
        slots:
          metricId: path.metricId
          dimensionFilter: requestBody.dimensionFilter
          activeSince: requestBody.activeSince
      method: generated
      generated: '2026-09-26'
- target: $.paths['/metrics/{metricId}/dimension/query'].post
  update:
    x-apievangelist-phrasing:
      intent: List a metric's dimension values
      effect: read
      questions:
      - What values does a given dimension take in my metric?
      - Can I search dimension values of a metric by a filter?
      instructions:
      - text: List values of dimension {dimensionName} for metric {metricId}.
        slots:
          dimensionName: requestBody.dimensionName
          metricId: path.metricId
      - text: Show dimension {dimensionName} values on metric {metricId} matching {dimensionValueFilter}.
        slots:
          dimensionName: requestBody.dimensionName
          metricId: path.metricId
          dimensionValueFilter: requestBody.dimensionValueFilter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/metrics/{metricId}/enrichment/anomalyDetection/configurations'].get
  update:
    x-apievangelist-phrasing:
      intent: List anomaly detection configs for a metric
      effect: read
      questions:
      - Which anomaly detection configurations are set up on this metric?
      - What detection settings are attached to a metric?
      instructions:
      - text: List anomaly detection configurations for metric {metricId}.
        slots:
          metricId: path.metricId
      - text: Show up to {maxpagesize} detection configs on metric {metricId}.
        slots:
          maxpagesize: query.$maxpagesize
          metricId: path.metricId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/metrics/{metricId}/status/enrichment/anomalyDetection/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Get anomaly detection enrichment status
      effect: read
      questions:
      - Has anomaly detection enrichment run for my metric over a period?
      - How do I check enrichment progress for a metric in a time window?
      instructions:
      - text: Get enrichment status for metric {metricId} from {startTime} to {endTime}.
        slots:
          metricId: path.metricId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      - text: Check whether anomaly detection enrichment finished on metric {metricId} since {startTime} until {endTime}.
        slots:
          metricId: path.metricId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'