# 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 Live Metrics REST APIs for client SDKs.
  version: 1.0.0
extends: openapi/microsoft-azure-quickpulseservice-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: 2
- target: $.paths['/QuickPulseService.svc/ping'].post
  update:
    x-apievangelist-phrasing:
      intent: Check whether anyone is watching live metrics
      effect: read
      questions:
      - How does my SDK know if someone has Live Metrics open for my app?
      - Can I ping Live Metrics to see if there is an active subscription before sending data?
      instructions:
      - text: Ping Live Metrics with instrumentation key {ikey} to see if anyone is subscribed.
        slots:
          ikey: query.ikey
      - text: Check for an active live metrics subscription for key {ikey} from machine {machine_name}.
        slots:
          ikey: query.ikey
          machine_name: header.x-ms-qps-machine-name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/QuickPulseService.svc/post'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish live metrics data points
      effect: write
      questions:
      - How do I send live metrics to the Live Metrics service?
      - Should live metrics be posted only when there is an active subscription?
      instructions:
      - text: Publish live metrics data points {data_points} for instrumentation key {ikey}.
        slots:
          data_points: body.monitoringDataPoints
          ikey: query.ikey
      - text: Post the current monitoring data to Live Metrics using key {ikey}.
        slots:
          ikey: query.ikey
      method: generated
      generated: '2026-09-26'