# 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…
  version: 1.0.0
extends: openapi/microsoft-azure-sqldiscoverysitedatasourcecontroller-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: 4
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/discoverySiteDataSources'].get
  update:
    x-apievangelist-phrasing:
      intent: List discovery data sources on a SQL site
      effect: read
      questions:
      - Which discovery data sources are feeding my Azure Migrate SQL site?
      - Can I see all the data sources attached to one SQL discovery site?
      instructions:
      - text: List discovery site data sources for SQL site {sqlSiteName} under master site {siteName}.
        slots:
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show every data source on master site {siteName}, SQL site {sqlSiteName}.
        slots:
          siteName: path.siteName
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/discoverySiteDataSources/{discoverySiteDataSourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL discovery site data source
      effect: read
      questions:
      - What appliance or source is behind a particular SQL discovery data source?
      - Can I look up one discovery data source on a SQL site by name?
      instructions:
      - text: Get data source {dataSource} on SQL site {sqlSiteName} under master site {siteName}.
        slots:
          dataSource: path.discoverySiteDataSourceName
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Show SQL discovery data source {dataSource} (master site {siteName}, SQL site {sqlSiteName}).
        slots:
          dataSource: path.discoverySiteDataSourceName
          siteName: path.siteName
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OffAzure/masterSites/{siteName}/sqlSites/{sqlSiteName}/discoverySiteDataSources/{discoverySiteDataSourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add a discovery data source to a SQL site
      effect: write
      questions:
      - How do I attach a new discovery data source to an Azure Migrate SQL site?
      - Can I register a data source for SQL discovery under a master site?
      instructions:
      - text: Create data source {dataSource} on SQL site {sqlSiteName} under master site {siteName}.
        slots:
          dataSource: path.discoverySiteDataSourceName
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Add SQL discovery data source {dataSource} to {sqlSiteName} on master site {siteName} with properties {properties}.
        slots:
          dataSource: path.discoverySiteDataSourceName
          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}/discoverySiteDataSources/{discoverySiteDataSourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a discovery data source from a SQL site
      effect: destructive
      questions:
      - How do I detach a discovery data source from my SQL site?
      - Can I delete one SQL discovery data source and keep the site?
      instructions:
      - text: Delete data source {dataSource} from SQL site {sqlSiteName} under master site {siteName}.
        slots:
          dataSource: path.discoverySiteDataSourceName
          sqlSiteName: path.sqlSiteName
          siteName: path.siteName
      - text: Detach SQL discovery data source {dataSource} (master site {siteName}, SQL site {sqlSiteName}).
        slots:
          dataSource: path.discoverySiteDataSourceName
          siteName: path.siteName
          sqlSiteName: path.sqlSiteName
      method: generated
      generated: '2026-09-26'