# 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 Host…
  version: 1.0.0
extends: openapi/microsoft-azure-hypervhostcontroller-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List Hyper-V hosts in a migration site
      effect: read
      questions:
      - Which Hyper-V hosts have been discovered in my Azure Migrate site?
      - Can I filter the hosts listed for a Hyper-V site?
      instructions:
      - text: List Hyper-V hosts in site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show hosts in Hyper-V site {siteName} matching {filter}.
        slots:
          siteName: path.siteName
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/hosts/{hostName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Hyper-V host in a site
      effect: read
      questions:
      - What do we know about one Hyper-V host in a discovery site?
      - Can I check a Hyper-V host's discovery status?
      instructions:
      - text: Get Hyper-V host {hostName} in site {siteName}.
        slots:
          siteName: path.siteName
          hostName: path.hostName
      - text: Show details of host {hostName} from Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
          hostName: path.hostName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/hosts/{hostName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a Hyper-V host to a site
      effect: write
      questions:
      - How do I register a Hyper-V host for discovery in a migration site?
      - Can I add a new host to my Hyper-V site?
      instructions:
      - text: Add Hyper-V host {hostName} to site {siteName}.
        slots:
          siteName: path.siteName
          hostName: path.hostName
      - text: Create host {hostName} in Hyper-V site {siteName} with {properties}.
        slots:
          hostName: path.hostName
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/hosts/{hostName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Hyper-V host from a site
      effect: destructive
      questions:
      - How do I stop discovering a Hyper-V host in my site?
      - Can a host be removed from a Hyper-V site?
      instructions:
      - text: Delete Hyper-V host {hostName} from site {siteName}.
        slots:
          siteName: path.siteName
          hostName: path.hostName
      - text: Remove host {hostName} from discovery in {siteName}.
        slots:
          siteName: path.siteName
          hostName: path.hostName
      method: generated
      generated: '2026-09-26'