# 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 Sql Sites…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlsitescontroller-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/masterSites/{siteName}/sqlSites'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL sites under an Azure Migrate master site
      effect: read
      questions:
      - Which SQL discovery sites belong to my Azure Migrate master site?
      - Can I list every SQL site registered to one master site?
      instructions:
      - text: List the SQL sites under master site {siteName}.
        slots:
          siteName: path.siteName
      - text: Show all SQL discovery sites in master site {siteName}.
        slots:
          siteName: path.siteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL site in an Azure Migrate master site
      effect: read
      questions:
      - How do I view one SQL site's discovery settings?
      - What appliance and properties does a given SQL site report?
      instructions:
      - text: Get SQL site {sqlSiteName} in master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show the configuration of SQL site {sqlSiteName}.
        slots:
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a SQL site in a master site
      effect: write
      questions:
      - Can I add a new SQL discovery site to an Azure Migrate master site?
      - What properties go into a new SQL site?
      instructions:
      - text: Create SQL site {sqlSiteName} under master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Register a new SQL site {sqlSiteName} in {siteName} with properties {properties}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SQL site from a master site
      effect: destructive
      questions:
      - How do I remove a SQL site from Azure Migrate discovery?
      - Is deleting a SQL site permanent?
      instructions:
      - text: Delete SQL site {sqlSiteName} from master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Remove the SQL discovery site {sqlSiteName} for good.
        slots:
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an existing SQL site
      effect: write
      questions:
      - Can I change the settings of an SQL site that already exists?
      - Which SQL site properties are updatable?
      instructions:
      - text: Update SQL site {sqlSiteName} in {siteName} with {properties}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
          properties: requestBody.properties
      - text: Patch the existing SQL site {sqlSiteName}.
        slots:
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/errorSummary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get the error summary for a SQL site
      effect: read
      questions:
      - What discovery errors has my SQL site hit?
      - Can I get a SQL site's error summary for one appliance?
      instructions:
      - text: Get the error summary for SQL site {sqlSiteName} in master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Summarize SQL site {sqlSiteName} errors for appliance {applianceName}.
        slots:
          sqlSiteName: path.sqlSiteName
          applianceName: requestBody.applianceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/exportSqlServerErrors'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a report of SQL Server discovery errors
      effect: read
      questions:
      - Can I export a report of SQL Server discovery errors from a SQL site?
      - Where do I get a downloadable list of SQL Server errors?
      instructions:
      - text: Export the SQL Server errors report for SQL site {sqlSiteName} in {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Generate an error report of discovered SQL Servers in site {sqlSiteName}.
        slots:
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/exportSqlServers'].post
  update:
    x-apievangelist-phrasing:
      intent: Export a report of discovered SQL Servers
      effect: read
      questions:
      - How do I export the list of SQL Servers found by a SQL site?
      - Can I filter the exported SQL Server inventory by appliance?
      instructions:
      - text: Export the discovered SQL Servers from SQL site {sqlSiteName} in {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Export SQL Server inventory from site {sqlSiteName} for appliance {applianceName} using filter {filter}.
        slots:
          sqlSiteName: path.sqlSiteName
          applianceName: requestBody.applianceName
          filter: requestBody.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/refresh'].post
  update:
    x-apievangelist-phrasing:
      intent: Refresh a SQL site's discovery
      effect: write
      questions:
      - Can I force a SQL site to refresh its discovered data?
      - Is it possible to refresh a SQL site for just one appliance agent?
      instructions:
      - text: Refresh SQL site {sqlSiteName} in master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Refresh site {sqlSiteName} using appliance {applianceName}.
        slots:
          sqlSiteName: path.sqlSiteName
          applianceName: requestBody.applianceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Get usage summary of a SQL site
      effect: read
      questions:
      - How many SQL servers and databases has my SQL site discovered?
      - What does the usage summary for a SQL site include?
      instructions:
      - text: Get the usage summary of SQL site {sqlSiteName} in {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show discovery counts for SQL site {sqlSiteName}.
        slots:
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'