# 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 Data Feed API
  version: 1.0.0
extends: openapi/microsoft-azure-data-feed-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: 5
- target: $.paths['/dataFeeds'].get
  update:
    x-apievangelist-phrasing:
      intent: List Metrics Advisor data feeds
      effect: read
      questions:
      - Which data feeds are set up in my Metrics Advisor resource?
      - Can I filter data feeds by source type, granularity, status or creator?
      - What paused data feeds do I have?
      instructions:
      - text: List all my data feeds.
      - text: Show data feeds from source type {dataSourceType} with status {status}.
        slots:
          dataSourceType: query.dataSourceType
          status: query.status
      - text: Find data feeds named {dataFeedName} created by {creator}.
        slots:
          dataFeedName: query.dataFeedName
          creator: query.creator
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new data feed for anomaly monitoring
      effect: write
      questions:
      - How do I connect a new data source so Metrics Advisor can monitor its metrics?
      - What do I have to specify when creating a data feed, like granularity and start date?
      instructions:
      - text: Create data feed {dataFeedName} from a {dataSourceType} source with {granularityName} granularity, metrics {metrics}, ingesting from {dataStartFrom}.
        slots:
          dataFeedName: requestBody.dataFeedName
          dataSourceType: requestBody.dataSourceType
          granularityName: requestBody.granularityName
          metrics: requestBody.metrics
          dataStartFrom: requestBody.dataStartFrom
      - text: Set up a new {dataSourceType} data feed {dataFeedName} tracking {metrics} with dimensions {dimension}.
        slots:
          dataSourceType: requestBody.dataSourceType
          dataFeedName: requestBody.dataFeedName
          metrics: requestBody.metrics
          dimension: requestBody.dimension
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds/{dataFeedId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data feed's configuration
      effect: read
      questions:
      - How is a particular data feed configured?
      - Can I look up one data feed by its id?
      instructions:
      - text: Show data feed {dataFeedId}.
        slots:
          dataFeedId: path.dataFeedId
      - text: Get the metrics, granularity and status of data feed {dataFeedId}.
        slots:
          dataFeedId: path.dataFeedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds/{dataFeedId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data feed
      effect: destructive
      questions:
      - How do I delete a data feed I no longer want monitored?
      - Can I permanently remove a data feed from Metrics Advisor?
      instructions:
      - text: Delete data feed {dataFeedId}.
        slots:
          dataFeedId: path.dataFeedId
      - text: Remove data feed {dataFeedId} and stop monitoring it.
        slots:
          dataFeedId: path.dataFeedId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataFeeds/{dataFeedId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing data feed
      effect: write
      questions:
      - How do I pause or rename an existing data feed?
      - Can I change who administers a data feed after it's created?
      instructions:
      - text: Set the status of {dataSourceType} data feed {dataFeedId} to {status}.
        slots:
          dataSourceType: requestBody.dataSourceType
          dataFeedId: path.dataFeedId
          status: requestBody.status
      - text: Rename {dataSourceType} data feed {dataFeedId} to {dataFeedName}.
        slots:
          dataSourceType: requestBody.dataSourceType
          dataFeedId: path.dataFeedId
          dataFeedName: requestBody.dataFeedName
      - text: Make {admins} the admins of existing data feed {dataFeedId} ({dataSourceType} source).
        slots:
          admins: requestBody.admins
          dataFeedId: path.dataFeedId
          dataSourceType: requestBody.dataSourceType
      method: generated
      generated: '2026-10-01'