# 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 Service Map Processes API
  version: 1.0.0
extends: openapi/microsoft-azure-processes-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: 6
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/processes'].get
  update:
    x-apievangelist-phrasing:
      intent: List processes on a Service Map machine
      effect: read
      questions:
      - Which processes were running on a machine in Service Map?
      - Can I list only processes that were live during a time window?
      instructions:
      - text: List processes on machine {machine} in workspace {workspace}, group {group}.
        slots:
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: List live processes on {machine} in {workspace} ({group}, subscription {subscription}) between {start} and {end}.
        slots:
          subscription: path.subscriptionId
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/processes/{processName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Service Map process
      effect: read
      questions:
      - How do I get details of one process on a Service Map machine?
      - Can I see a process as it was at a specific timestamp?
      instructions:
      - text: Get process {process} on machine {machine} in workspace {workspace}, group {group}.
        slots:
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show process {process} on {machine} in {workspace} ({group}, subscription {subscription}) at {timestamp}.
        slots:
          subscription: path.subscriptionId
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
          timestamp: query.timestamp
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/processes/{processName}/liveness'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a process was live
      effect: read
      questions:
      - Was a given process alive during a time interval?
      - How do I check a Service Map process's liveness status?
      instructions:
      - text: Check liveness of process {process} on {machine} in {workspace} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Check if process {process} on {machine} in {workspace}, group {group}, was live from {start} to {end}.
        slots:
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/processes/{processName}/acceptingPorts'].get
  update:
    x-apievangelist-phrasing:
      intent: List ports a process is listening on
      effect: read
      questions:
      - Which ports is a process accepting connections on?
      - What listening ports did a Service Map process have in a time window?
      instructions:
      - text: List ports process {process} accepts on, machine {machine}, workspace {workspace}, group {group}.
        slots:
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show listening ports for {process} on {machine} in {workspace} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/processes/{processName}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List network connections of a process
      effect: read
      questions:
      - What network connections start or end at a specific process?
      - Can I see a process's inbound and outbound connections over a time range?
      instructions:
      - text: List connections for process {process} on {machine} in {workspace}, group {group}.
        slots:
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Show connections of {process} on {machine} in {workspace} ({group}, sub {subscription}) from {start} to {end}.
        slots:
          subscription: path.subscriptionId
          process: path.processName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/ports/{portName}/acceptingProcesses'].get
  update:
    x-apievangelist-phrasing:
      intent: List processes listening on a port
      effect: read
      questions:
      - Which processes are accepting connections on a given port?
      - What's listening on a specific port of a Service Map machine?
      instructions:
      - text: List processes accepting on port {port} of machine {machine} in {workspace}, group {group}.
        slots:
          port: path.portName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      - text: Find what is listening on port {port} on {machine} in {workspace} ({group}, subscription {subscription}).
        slots:
          subscription: path.subscriptionId
          port: path.portName
          machine: path.machineName
          workspace: path.workspaceName
          group: path.resourceGroupName
      method: generated
      generated: '2026-09-26'