# 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-serversitescontroller-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: 15
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.OffAzure/serverSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List server sites in a subscription
      effect: read
      questions:
      - Which Azure Migrate server discovery sites exist across my subscription?
      - Can I see all server sites without narrowing to a resource group?
      instructions:
      - text: List all Azure Migrate server sites in my subscription.
      - text: Show every server discovery site subscription-wide.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List server sites in a resource group
      effect: read
      questions:
      - What server discovery sites are in my current resource group?
      - Can I list Azure Migrate server sites for just one resource group?
      instructions:
      - text: List the server sites in this resource group.
      - text: Show Azure Migrate server discovery sites scoped to the resource group.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a server site
      effect: read
      questions:
      - What are the details of one Azure Migrate server site?
      - Can I look up a server discovery site by its name?
      instructions:
      - text: Get server site {site}.
        slots:
          site: path.siteName
      - text: Show the configuration of server discovery site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a server site
      effect: write
      questions:
      - How do I create a server site for Azure Migrate discovery?
      - Can I set up a new server discovery site with custom properties?
      instructions:
      - text: Create server site {site}.
        slots:
          site: path.siteName
      - text: Set up a new Azure Migrate server discovery site named {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a server site
      effect: destructive
      questions:
      - Can I delete an Azure Migrate server discovery site?
      - What happens to discovery data when I remove a server site?
      instructions:
      - text: Delete server site {site}.
        slots:
          site: path.siteName
      - text: Remove Azure Migrate server discovery site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a server site
      effect: write
      questions:
      - Can I change tags or properties on an existing server site?
      - Is it possible to patch a server discovery site in place?
      instructions:
      - text: Update tags on server site {site} to {tags}.
        slots:
          site: path.siteName
          tags: requestBody.tags
      - text: Patch the properties of server discovery site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/computeErrorSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the error summary for a server site
      effect: read
      questions:
      - What discovery errors has my server site run into?
      - Can I get a summary of errors for one Azure Migrate server site?
      instructions:
      - text: Compute the error summary for server site {site}.
        slots:
          site: path.siteName
      - text: Summarize discovery errors on server site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/computeusage'].post
  update:
    x-apievangelist-phrasing:
      intent: Compute usage for a server site
      effect: read
      questions:
      - How much has my server discovery site been used?
      - Can I compute the usage figures for one server site?
      instructions:
      - text: Compute usage for server site {site}.
        slots:
          site: path.siteName
      - text: Show the computed usage of Azure Migrate server site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/exportApplications'].post
  update:
    x-apievangelist-phrasing:
      intent: Export discovered applications for a server site
      effect: write
      questions:
      - Can I export a report of applications installed on discovered machines?
      - How do I get the deep application discovery results for a site as a report?
      instructions:
      - text: Export the application inventory report for server site {site}.
        slots:
          site: path.siteName
      - text: Generate a machines-and-installed-applications report for site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/exportMachineErrors'].post
  update:
    x-apievangelist-phrasing:
      intent: Export machine discovery errors for a server site
      effect: write
      questions:
      - Can I export which machines hit errors during guest discovery?
      - Is there a report of guest discovery failures per machine?
      instructions:
      - text: Export machine errors for server site {site}.
        slots:
          site: path.siteName
      - text: Generate a guest discovery error report for machines in site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/listHealthSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the health summary of a server site
      effect: read
      questions:
      - Is my Azure Migrate server site healthy?
      - Where can I see the health summary of a server discovery site?
      instructions:
      - text: List the health summary for server site {site}.
        slots:
          site: path.siteName
      - text: Check the health of server discovery site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/refreshSite'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a server site
      effect: write
      questions:
      - Can I trigger a refresh of a server discovery site?
      - How do I make a server site re-sync its discovery data?
      instructions:
      - text: Refresh server site {site}.
        slots:
          site: path.siteName
      - text: Trigger a refresh on Azure Migrate server site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the site usage summary for a server site
      effect: read
      questions:
      - What does the overall usage summary of my server site look like?
      - Can I pull a usage summary for a server discovery site?
      instructions:
      - text: Get the summary for server site {site}.
        slots:
          site: path.siteName
      - text: Show the site usage summary of {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/updateDependencyMapStatus'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable dependency mapping on machines
      effect: write
      questions:
      - Can I turn dependency mapping on or off for machines in a site?
      - How do I enable dependency map collection for specific discovered machines?
      instructions:
      - text: Update dependency map status for machines {machines} in server site {site}.
        slots:
          machines: requestBody.machines
          site: path.siteName
      - text: Disable dependency mapping on the listed machines in site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/serverSites/{siteName}/updateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Update custom properties for discovered servers
      effect: write
      questions:
      - Can I set custom properties on servers discovered in a site?
      - Is there a bulk way to update properties of discovered servers?
      instructions:
      - text: Update custom server properties in site {site} with {value}.
        slots:
          site: path.siteName
          value: requestBody.value
      - text: Apply custom properties to discovered servers in server site {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'