# 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 Web Servers Controller API
  version: 1.0.0
extends: openapi/microsoft-azure-webserverscontroller-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}/webServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovered web servers in a web app site
      effect: read
      questions:
      - Which on-premises web servers were discovered for a web app site in Azure Migrate?
      - Can I filter or page the discovered web server list for a site?
      instructions:
      - text: List web servers discovered under web app site {webAppSiteName} of master site {siteName}.
        slots:
          webAppSiteName: path.webAppSiteName
          siteName: path.siteName
      - text: Show the top {top} web servers in web app site {webAppSiteName} matching {filter}.
        slots:
          top: query.top
          webAppSiteName: path.webAppSiteName
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/webServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List web servers in a Migrate project
      effect: read
      questions:
      - Which web servers are recorded in my Azure Migrate project?
      - Can I set a page size when listing a Migrate project's web servers?
      instructions:
      - text: List web servers in Migrate project {migrateProjectName}.
        slots:
          migrateProjectName: path.migrateProjectName
      - text: Show {pageSize} web servers per page from Migrate project {migrateProjectName}.
        slots:
          pageSize: query.pageSize
          migrateProjectName: path.migrateProjectName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Migrate/migrateProjects/{migrateProjectName}/webServers/{webServerId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web server in a Migrate project
      effect: read
      questions:
      - What does my Migrate project know about a specific web server?
      - Can I look up one web server in a Migrate project by ID?
      instructions:
      - text: Get web server {webServerId} in Migrate project {migrateProjectName}.
        slots:
          webServerId: path.webServerId
          migrateProjectName: path.migrateProjectName
      - text: Show Migrate project {migrateProjectName}'s record for web server {webServerId}.
        slots:
          migrateProjectName: path.migrateProjectName
          webServerId: path.webServerId
      method: generated
      generated: '2026-09-26'