# 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 Sites…
  version: 1.0.0
extends: openapi/microsoft-azure-sitescontroller-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: 13
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.OffAzure/vmwareSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List VMware discovery sites across a subscription
      effect: read
      questions:
      - Which VMware sites have I set up for Azure Migrate discovery across my whole subscription?
      - Can I see every VMware site in the subscription regardless of resource group?
      instructions:
      - text: List all VMware sites in my subscription.
      - text: Show every VMware discovery site across all resource groups.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List VMware discovery sites in a resource group
      effect: read
      questions:
      - What VMware sites live in one particular resource group?
      - Can I narrow the VMware site list down to a single resource group?
      instructions:
      - text: List the VMware sites in this resource group.
      - text: Show VMware discovery sites scoped to my current resource group only.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a VMware discovery site
      effect: read
      questions:
      - What are the properties of a specific VMware site?
      - Can I look up a single VMware site by name?
      instructions:
      - text: Get VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show the configuration of VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a VMware discovery site
      effect: write
      questions:
      - How do I create a new VMware site for discovering on-premises machines?
      - Can I pass an eTag when creating a VMware site?
      instructions:
      - text: Create VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Create VMware 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/vmwareSites/{siteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a VMware discovery site
      effect: destructive
      questions:
      - Can I remove a VMware site I no longer need for migration discovery?
      - What do I need to delete a VMware site?
      instructions:
      - text: Delete VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Remove the VMware discovery site called {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags or properties of a VMware site
      effect: write
      questions:
      - Can I change the tags on an existing VMware site?
      - Which VMware site properties can be patched after creation?
      instructions:
      - text: Update the tags on VMware site {siteName} to {tags}.
        slots:
          siteName: path.siteName
          tags: requestBody.tags
      - text: Patch VMware 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/vmwareSites/{siteName}/computeErrorSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Compute the error summary for a VMware site
      effect: read
      questions:
      - What errors has discovery hit on my VMware site?
      - Can I get a rolled-up error summary for one VMware site?
      instructions:
      - text: Compute the error summary for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Summarize discovery errors on VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/computeusage'].post
  update:
    x-apievangelist-phrasing:
      intent: Compute usage for a VMware site
      effect: read
      questions:
      - How much is my VMware discovery site being used?
      - Can I compute usage figures for a VMware site?
      instructions:
      - text: Compute usage for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Run the compute-usage calculation on VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/exportApplications'].post
  update:
    x-apievangelist-phrasing:
      intent: Export discovered applications report for a site
      effect: read
      questions:
      - Can I export a report of the applications installed on machines in my VMware site?
      - What report shows deep application discovery for each VMware machine?
      instructions:
      - text: Export the installed-applications report for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Generate the application inventory export for VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/exportMachineErrors'].post
  update:
    x-apievangelist-phrasing:
      intent: Export guest discovery errors for a site
      effect: read
      questions:
      - Which VMware machines failed guest discovery, and why?
      - Can I export a report of machine errors from a VMware site?
      instructions:
      - text: Export the machine errors report for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Generate a guest-discovery error export for VMware site {siteName} using options {properties}.
        slots:
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/exportMachines'].post
  update:
    x-apievangelist-phrasing:
      intent: Export the discovered machines report for a site
      effect: read
      questions:
      - Can I export a list of all machines discovered in a VMware site?
      - Is there a way to filter the machines included in a VMware site export?
      instructions:
      - text: Export the discovered machines report for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Export machines from VMware site {siteName} matching filter {filter}.
        slots:
          siteName: path.siteName
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/listHealthSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the health summary of a VMware site
      effect: read
      questions:
      - Is my VMware discovery site healthy?
      - What does the health summary for a VMware site report?
      instructions:
      - text: Show the health summary for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Check the health of VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/vmwareSites/{siteName}/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the usage summary of a VMware site
      effect: read
      questions:
      - What overall usage summary does my VMware site report?
      - Can I get a single summary view of a VMware site's discovery?
      instructions:
      - text: Get the site summary for VMware site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show me the overview summary of VMware site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'