# 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 Azure Migrate Discovery Service Hyperv…
  version: 1.0.0
extends: openapi/microsoft-azure-hypervdependencymapcontroller-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.OffAzure/hypervSites/{siteName}/clientGroupMembers'].post
  update:
    x-apievangelist-phrasing:
      intent: List members of a client group in a Hyper-V dependency map
      effect: read
      questions:
      - Which machines are in a client group of my Hyper-V site's dependency map?
      - Can I see client group members for a given process over a time window?
      instructions:
      - text: List client group members for machine {machineId} process {processName} in Hyper-V site {siteName}.
        slots:
          machineId: requestBody.machineId
          processName: requestBody.processName
          siteName: path.siteName
      - text: Show client group members in site {siteName} from {startTime} to {endTime}.
        slots:
          siteName: path.siteName
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/exportDependencies'].post
  update:
    x-apievangelist-phrasing:
      intent: Export agentless dependency data for a Hyper-V site
      effect: read
      questions:
      - How do I export a report of agentless dependencies from a Hyper-V site?
      - Can I limit the Hyper-V dependency export to a date range?
      instructions:
      - text: Export agentless dependencies for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Export dependencies for site {siteName} between {startTime} and {endTime}.
        slots:
          siteName: path.siteName
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/generateCoarseMap'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a coarse dependency map for Hyper-V machines
      effect: read
      questions:
      - How do I generate a high-level dependency map across machines in a Hyper-V site?
      - Can I filter which machines appear in the coarse map?
      instructions:
      - text: Generate a coarse dependency map for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Build a coarse map for site {siteName} from {startTime} to {endTime} using filters {filters}.
        slots:
          siteName: path.siteName
          startTime: requestBody.startTime
          endTime: requestBody.endTime
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/generateDetailedMap'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a detailed dependency map for one Hyper-V machine
      effect: read
      questions:
      - How do I see the detailed process-level dependencies of one Hyper-V machine?
      - What does the detailed dependency map show for a selected machine?
      instructions:
      - text: Generate a detailed dependency map for machine {machineId} in Hyper-V site {siteName}.
        slots:
          machineId: requestBody.machineId
          siteName: path.siteName
      - text: Build a detailed map of {machineId} between {startTime} and {endTime}.
        slots:
          machineId: requestBody.machineId
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/serverGroupMembers'].post
  update:
    x-apievangelist-phrasing:
      intent: List members of a server group in a Hyper-V dependency map
      effect: read
      questions:
      - Which servers listen on a given port in my Hyper-V dependency map?
      - Can I list server group members for a port over a time range?
      instructions:
      - text: List server group members on port {serverPort} in Hyper-V site {siteName}.
        slots:
          serverPort: requestBody.serverPort
          siteName: path.siteName
      - text: Show server group members in site {siteName} from {startTime} to {endTime}.
        slots:
          siteName: path.siteName
          startTime: requestBody.startTime
          endTime: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/updateDependencyMapStatus'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn dependency mapping on or off for Hyper-V machines
      effect: write
      questions:
      - How do I enable dependency mapping for specific Hyper-V machines?
      - Can I disable dependency map collection on some machines in a site?
      instructions:
      - text: Update dependency map status for machines {machines} in Hyper-V site {siteName}.
        slots:
          machines: requestBody.machines
          siteName: path.siteName
      - text: Enable or disable dependency mapping in site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'