# 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 Web App…
  version: 1.0.0
extends: openapi/microsoft-azure-webappsitescontroller-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: 9
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List web app sites under a master site
      effect: read
      questions:
      - Which web app discovery sites belong to my Azure Migrate master site?
      - How do I list web app sites for one master site?
      instructions:
      - text: List web app sites under master site {site}.
        slots:
          site: path.siteName
      - text: Show all web app discovery sites in {site}.
        slots:
          site: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a web app discovery site
      effect: read
      questions:
      - How do I view the details of one web app site in Azure Migrate?
      - What does a web app site under a master site contain?
      instructions:
      - text: Get web app site {web_app_site} in master site {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Show details of web app site {web_app_site}.
        slots:
          web_app_site: path.webAppSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a web app discovery site
      effect: write
      questions:
      - How do I create a new web app site under a master site?
      - What properties are set when creating a WebApp site for migration discovery?
      instructions:
      - text: Create web app site {web_app_site} under master site {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Set up web app site {web_app_site} in {site} with {properties}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a web app discovery site
      effect: destructive
      questions:
      - Can I remove a web app site from my master site?
      - What happens when I delete a WebApp site in Azure Migrate?
      instructions:
      - text: Delete web app site {web_app_site} from master site {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Remove the WebApp site {web_app_site}.
        slots:
          web_app_site: path.webAppSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing web app discovery site
      effect: write
      questions:
      - How do I change settings on a web app site that already exists?
      - Can I patch the properties of a WebApp site?
      instructions:
      - text: Update web app site {web_app_site} in {site} with {properties}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
          properties: requestBody.properties
      - text: Patch the existing WebApp site {web_app_site}.
        slots:
          web_app_site: path.webAppSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}/errorSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the error summary for a web app site
      effect: read
      questions:
      - What discovery errors has my web app site hit?
      - Can I get an error summary for a specific appliance on a web app site?
      instructions:
      - text: Get the error summary for web app site {web_app_site} in {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Show discovery errors on {web_app_site} for appliance {appliance}.
        slots:
          web_app_site: path.webAppSiteName
          appliance: requestBody.applianceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}/exportInventory'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a web app inventory report
      effect: read
      questions:
      - How do I generate a report of all discovered web apps?
      - Can I filter the web app inventory export?
      instructions:
      - text: Export the web app inventory for {web_app_site} in {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Generate a web app inventory report for {web_app_site} filtered by {filter}.
        slots:
          web_app_site: path.webAppSiteName
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a web app discovery site
      effect: write
      questions:
      - How do I trigger a fresh discovery run on a web app site?
      - Can I refresh a web app site for one appliance?
      instructions:
      - text: Refresh web app site {web_app_site} in {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Rerun discovery on {web_app_site} for appliance {appliance}.
        slots:
          web_app_site: path.webAppSiteName
          appliance: requestBody.applianceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/webAppSites/{webAppSiteName}/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get usage summary for a web app site
      effect: read
      questions:
      - How many web apps has my site discovered so far?
      - Where do I see usage numbers for a web app site?
      instructions:
      - text: Get the usage summary for web app site {web_app_site} in {site}.
        slots:
          web_app_site: path.webAppSiteName
          site: path.siteName
      - text: Summarize discovery counts for {web_app_site}.
        slots:
          web_app_site: path.webAppSiteName
      method: generated
      generated: '2026-09-26'