# 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-hypervsitescontroller-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: 10
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Hyper-V discovery site
      effect: read
      questions:
      - How do I check the configuration of a Hyper-V site in Azure Migrate discovery?
      - Which appliance and agent details are recorded for a given Hyper-V site?
      instructions:
      - text: Get Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show the properties of Azure Migrate Hyper-V discovery site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a Hyper-V discovery site
      effect: write
      questions:
      - How do I register a new Hyper-V site for migration discovery?
      - Can I set up a Hyper-V site with my appliance settings in one call?
      instructions:
      - text: Create Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Register a new Hyper-V discovery site {siteName} with properties {properties}.
        slots:
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Hyper-V discovery site
      effect: destructive
      questions:
      - How do I remove a Hyper-V site from Azure Migrate once discovery is done?
      - Can I delete a Hyper-V site I registered by mistake?
      instructions:
      - text: Delete Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Remove the Hyper-V discovery site {siteName} permanently.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a Hyper-V discovery site
      effect: write
      questions:
      - Can I change tags on an existing Hyper-V site?
      - What properties of a Hyper-V site can I modify after it's registered?
      instructions:
      - text: Tag Hyper-V site {siteName} with {tags}.
        slots:
          siteName: path.siteName
          tags: requestBody.tags
      - text: Update existing Hyper-V site {siteName} properties to {properties}.
        slots:
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/computeErrorSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Hyper-V site's error summary
      effect: read
      questions:
      - What discovery errors has my Hyper-V site run into?
      - Is there a roll-up of error counts for a Hyper-V site?
      instructions:
      - text: Compute the error summary for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Summarize discovery errors on site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/computeusage'].post
  update:
    x-apievangelist-phrasing:
      intent: Compute a Hyper-V site's usage
      effect: read
      questions:
      - How many hosts, clusters and machines has a Hyper-V site discovered?
      - Can I compute current resource usage counts for one Hyper-V site?
      instructions:
      - text: Compute usage for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Count the discovered hosts and servers in site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/exportApplications'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a Hyper-V site's application inventory
      effect: write
      questions:
      - How do I get a report of applications installed on machines in a Hyper-V site?
      - Can I export the deep application discovery results for my Hyper-V servers?
      instructions:
      - text: Export the applications report for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Generate the installed-software inventory for machines in site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/exportMachineErrors'].post
  update:
    x-apievangelist-phrasing:
      intent: Export machine guest-discovery errors
      effect: write
      questions:
      - Which machines hit errors during guest discovery on my Hyper-V site?
      - Can I download a report of per-machine discovery failures?
      instructions:
      - text: Export machine errors for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Generate the guest discovery failure report for site {siteName} with options {properties}.
        slots:
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/listHealthSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Hyper-V site's health summary
      effect: read
      questions:
      - Is my Hyper-V discovery site healthy?
      - Where can I see health issues affecting a Hyper-V site's appliance?
      instructions:
      - text: Get the health summary of Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: List health problems reported for site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/hypervSites/{siteName}/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Hyper-V site's usage summary
      effect: read
      questions:
      - Can I get an overall site usage summary for a Hyper-V site?
      - What does the summary view report for my Hyper-V discovery site?
      instructions:
      - text: Get the site summary for Hyper-V site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show the overview summary of site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'