# 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 Ingestion Status API
  version: 1.0.0
extends: openapi/microsoft-azure-ingestion-status-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: 3
- target: $.paths['/dataFeeds/{dataFeedId}/ingestionStatus/query'].post
  update:
    x-apievangelist-phrasing:
      intent: Get data ingestion status for a data feed
      effect: read
      questions:
      - Did my Metrics Advisor data feed ingest successfully over a time range?
      - Can I page through ingestion statuses for a data feed?
      instructions:
      - text: Get ingestion status for data feed {feed} from {start} to {end}.
        slots:
          feed: path.dataFeedId
          start: requestBody.startTime
          end: requestBody.endTime
      - text: Show up to {size} ingestion status records for data feed {feed} between {start} and {end}.
        slots:
          size: query.$maxpagesize
          feed: path.dataFeedId
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds/{dataFeedId}/ingestionProgress/reset'].post
  update:
    x-apievangelist-phrasing:
      intent: Reset ingestion status to backfill a data feed
      effect: write
      questions:
      - How do I re-ingest data for a past period in Metrics Advisor?
      - Can I reset a data feed's ingestion progress to backfill missing points?
      instructions:
      - text: Reset ingestion for data feed {feed} from {start} to {end}.
        slots:
          feed: path.dataFeedId
          start: requestBody.startTime
          end: requestBody.endTime
      - text: Backfill data feed {feed} between {start} and {end}.
        slots:
          feed: path.dataFeedId
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds/{dataFeedId}/ingestionProgress'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the last successful ingestion time for a feed
      effect: read
      questions:
      - When did my data feed last ingest successfully?
      - What is the latest successful ingestion job timestamp for a feed?
      instructions:
      - text: Get the ingestion progress of data feed {feed}.
        slots:
          feed: path.dataFeedId
      - text: Show the last successful ingestion time for data feed {feed}.
        slots:
          feed: path.dataFeedId
      method: generated
      generated: '2026-10-01'