# 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 AzureDataManagementClient Sql Servers API
  version: 1.0.0
extends: openapi/microsoft-azure-sqlservers-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.AzureData/sqlServerRegistrations/{sqlServerRegistrationName}/sqlServers/{sqlServerName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL Server in a registration
      effect: read
      questions:
      - What details are recorded for a SQL Server in my SQL Server registration?
      - Can I expand extra properties when fetching a registered SQL Server?
      instructions:
      - text: Get SQL Server {server} in registration {registration} in {rg} of subscription {sub}.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show registered SQL Server {server} from {registration} with {expand} expanded.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureData/sqlServerRegistrations/{sqlServerRegistrationName}/sqlServers/{sqlServerName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SQL Server in a registration
      effect: write
      questions:
      - How do I add a SQL Server to a SQL Server registration?
      - Can I update the properties of a SQL Server that is already registered?
      instructions:
      - text: Add SQL Server {server} to registration {registration} in {rg} of subscription {sub}.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update registered SQL Server {server} in {registration} with properties {properties}.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureData/sqlServerRegistrations/{sqlServerRegistrationName}/sqlServers/{sqlServerName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SQL Server from a registration
      effect: destructive
      questions:
      - Can I remove a SQL Server from a SQL Server registration?
      - What happens when a registered SQL Server is deleted?
      instructions:
      - text: Delete SQL Server {server} from registration {registration} in {rg} of subscription {sub}.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Remove registered SQL Server {server} from {registration}.
        slots:
          server: path.sqlServerName
          registration: path.sqlServerRegistrationName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureData/sqlServerRegistrations/{sqlServerRegistrationName}/sqlServers'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL Servers in a registration
      effect: read
      questions:
      - Which SQL Servers are in my SQL Server registration?
      - Can I list every SQL Server under one registration?
      instructions:
      - text: List SQL Servers in registration {registration} in {rg} of subscription {sub}.
        slots:
          registration: path.sqlServerRegistrationName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show all servers in SQL Server registration {registration} with {expand} expanded.
        slots:
          registration: path.sqlServerRegistrationName
          expand: query.$expand
      method: generated
      generated: '2026-09-26'