# 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 Ports API
  version: 1.0.0
extends: openapi/microsoft-azure-ports-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['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/ports'].get
  update:
    x-apievangelist-phrasing:
      intent: List live ports on a machine
      effect: read
      questions:
      - Which ports were live on a machine in Service Map during a time window?
      - Can I see open ports on a monitored machine between two times?
      instructions:
      - text: List live ports on machine {machine} in workspace {workspace}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
      - text: List ports live on machine {machine} in workspace {workspace} between {start} and {end}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          start: query.startTime
          end: query.endTime
      - text: Show ports on machine {machine}, workspace {workspace}, resource group {rg}, subscription {subscription}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/ports/{portName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a port on a machine
      effect: read
      questions:
      - How do I get details of one port on a Service Map machine?
      - Why would a port lookup return 404 for my time interval?
      instructions:
      - text: Get port {port} on machine {machine} in workspace {workspace}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
      - text: Get port {port} on machine {machine}, workspace {workspace}, group {rg}, subscription {subscription}, from {start} to {end}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
          subscription: path.subscriptionId
          rg: 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}/liveness'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a port's liveness
      effect: read
      questions:
      - Was a specific port live during a given time interval?
      - How do I check the liveness status of a port on a monitored machine?
      instructions:
      - text: Check liveness of port {port} on machine {machine} in workspace {workspace}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
      - text: Check if port {port} on machine {machine} was live from {start} to {end} in workspace {workspace}, group {rg}, subscription {subscription}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
          subscription: path.subscriptionId
          rg: 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 accepting on a port
      effect: read
      questions:
      - Which processes are listening on a given port of a machine?
      - Can I see what process accepted connections on a port during a time window?
      instructions:
      - text: List processes accepting on port {port} of machine {machine} in workspace {workspace}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
      - text: Show listening processes for port {port}, machine {machine}, workspace {workspace}, group {rg}, subscription {subscription}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
          subscription: path.subscriptionId
          rg: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}/ports/{portName}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List connections through a port
      effect: read
      questions:
      - Which connections were established through a specific port?
      - Can I see traffic connections on a machine's port within a time range?
      instructions:
      - text: List connections via port {port} on machine {machine} in workspace {workspace}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
      - text: Show connections through port {port}, machine {machine}, workspace {workspace}, group {rg}, subscription {subscription}, from {start} to {end}.
        slots:
          workspace: path.workspaceName
          machine: path.machineName
          port: path.portName
          subscription: path.subscriptionId
          rg: path.resourceGroupName
          start: query.startTime
          end: query.endTime
      method: generated
      generated: '2026-09-26'