# 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 Server…
  version: 1.0.0
extends: openapi/microsoft-azure-serverdependencymapcontroller-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.OffAzure/serverSites/{siteName}/clientGroupMembers'].post
  update:
    x-apievangelist-phrasing:
      intent: List members of a client group in a dependency map
      effect: read
      questions:
      - Which machines are in a client group on my dependency map?
      - Can I narrow client group members to a specific process and time window?
      instructions:
      - text: List client group members on site {site} for machine {machine} and process group {process_group}.
        slots:
          site: path.siteName
          machine: requestBody.machineId
          process_group: requestBody.processGroupName
      - text: Show client group members on {site} between {start} and {end}.
        slots:
          site: path.siteName
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/exportDependencies'].post
  update:
    x-apievangelist-phrasing:
      intent: Export agentless dependency data
      effect: read
      questions:
      - How do I download a report of agentless server dependencies?
      - Can I export dependencies for a specific date range?
      instructions:
      - text: Export agentless dependencies for site {site} from {start} to {end}.
        slots:
          site: path.siteName
          start: requestBody.startTime
          end: requestBody.endTime
      - text: Generate a dependency report for server site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/generateCoarseMap'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a coarse dependency map of machines
      effect: read
      questions:
      - How do I get a high-level dependency map across many machines?
      - Can I filter the coarse map to certain machines and a time window?
      instructions:
      - text: Generate a coarse dependency map for site {site} from {start} to {end}.
        slots:
          site: path.siteName
          start: requestBody.startTime
          end: requestBody.endTime
      - text: Build a coarse map on {site} using filters {filters}.
        slots:
          site: path.siteName
          filters: requestBody.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/generateDetailedMap'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a detailed dependency map for one machine
      effect: read
      questions:
      - How do I see the detailed connections of a single machine?
      - Can I get process-level dependencies for one server over a time range?
      instructions:
      - text: Generate a detailed dependency map for machine {machine} on site {site}.
        slots:
          machine: requestBody.machineId
          site: path.siteName
      - text: Map detailed dependencies of {machine} from {start} to {end}.
        slots:
          machine: requestBody.machineId
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/serverGroupMembers'].post
  update:
    x-apievangelist-phrasing:
      intent: List members of a server group in a dependency map
      effect: read
      questions:
      - Which servers listen on a given port in my dependency map's server group?
      - How do I list members of a selected server group?
      instructions:
      - text: List server group members on site {site} for port {port}.
        slots:
          site: path.siteName
          port: requestBody.serverPort
      - text: Show server group members on {site} between {start} and {end}.
        slots:
          site: path.siteName
          start: requestBody.startTime
          end: requestBody.endTime
      method: generated
      generated: '2026-09-26'