# 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 Servers…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlserverscontroller-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}/sqlSites/{sqlSiteName}/sqlServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovered SQL servers in a SQL site
      effect: read
      questions:
      - Which on-premises SQL servers did Azure Migrate discover in a SQL site?
      - Can I filter discovered SQL servers and get a total record count?
      instructions:
      - text: List SQL servers in SQL site {sqlSiteName} of master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show up to {top} SQL servers in {sqlSiteName} matching {filter}.
        slots:
          top: query.top
          sqlSiteName: path.sqlSiteName
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/sqlServers/{sqlServerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a discovered SQL server
      effect: read
      questions:
      - What details were discovered for a specific on-premises SQL server?
      - Can I look up one SQL server in an Azure Migrate SQL site?
      instructions:
      - text: Get SQL server {sqlServerName} in SQL site {sqlSiteName}, master site {siteName}.
        slots:
          sqlServerName: path.sqlServerName
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show discovery details of SQL server {sqlServerName}.
        slots:
          sqlServerName: path.sqlServerName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/sqlServers/{sqlServerName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a discovered SQL server
      effect: write
      questions:
      - Can I tag a discovered SQL server in Azure Migrate?
      - Which fields of a discovered SQL server record can I change?
      instructions:
      - text: Update tags of SQL server {sqlServerName} in {sqlSiteName}, master site {siteName}.
        slots:
          sqlServerName: path.sqlServerName
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Patch SQL server {sqlServerName} with properties {properties}.
        slots:
          sqlServerName: path.sqlServerName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'