# 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 SqlVirtualMachineManagementClient Sql…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlvirtualmachines-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.SqlVirtualMachine/sqlVirtualMachineGroups/{sqlVirtualMachineGroupName}/sqlVirtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL VMs in a SQL virtual machine group
      effect: read
      questions:
      - Which SQL virtual machines belong to a SQL VM group?
      - What machines are members of my availability group's SQL VM group?
      instructions:
      - text: List SQL virtual machines in SQL VM group {sqlVirtualMachineGroupName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          sqlVirtualMachineGroupName: path.sqlVirtualMachineGroupName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the members of SQL virtual machine group {sqlVirtualMachineGroupName}.
        slots:
          sqlVirtualMachineGroupName: path.sqlVirtualMachineGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List all SQL virtual machines in a subscription
      effect: read
      questions:
      - What SQL Server VMs are registered across my entire subscription?
      - Can I see every SQL IaaS VM subscription-wide?
      instructions:
      - text: List all SQL virtual machines in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every SQL Server virtual machine resource across the subscription.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL virtual machine
      effect: read
      questions:
      - How do I check the configuration of one SQL Server VM?
      - Can I expand a SQL VM's details to include its assessment or other child info?
      instructions:
      - text: Get SQL virtual machine {sqlVirtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show SQL VM {sqlVirtualMachineName} with {expand} expanded.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          expand: query.$expand
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Register or reconfigure a SQL virtual machine
      effect: write
      questions:
      - How do I register an Azure VM with the SQL IaaS extension?
      - Can I change license type or backup settings for a SQL Server VM?
      instructions:
      - text: Create SQL virtual machine {sqlVirtualMachineName} in {resourceGroupName} (subscription {subscriptionId}) at {location}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Update SQL VM {sqlVirtualMachineName} with properties {properties}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SQL virtual machine resource
      effect: destructive
      questions:
      - How do I unregister a VM from the SQL IaaS extension?
      - Can I delete a SQL virtual machine resource?
      instructions:
      - text: Delete SQL virtual machine {sqlVirtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove the SQL VM resource {sqlVirtualMachineName}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update tags on a SQL virtual machine
      effect: write
      questions:
      - Can I change just the tags on a SQL Server VM resource?
      - How do I retag a SQL virtual machine without touching its configuration?
      instructions:
      - text: Set tags {tags} on SQL virtual machine {sqlVirtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          tags: requestBody.tags
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Patch the tags of SQL VM {sqlVirtualMachineName}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL virtual machines in a resource group
      effect: read
      questions:
      - Which SQL Server VMs are in this resource group?
      - What SQL virtual machines does one resource group hold?
      instructions:
      - text: List SQL virtual machines in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the SQL VMs under {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/startAssessment'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a SQL best practices assessment
      effect: write
      questions:
      - How do I kick off a SQL best practices assessment on a SQL Server VM?
      - Can I run an on-demand assessment of my SQL VM configuration?
      instructions:
      - text: Start a SQL best practices assessment on {sqlVirtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Run the SQL assessment for VM {sqlVirtualMachineName}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/redeploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Reinstall the SQL IaaS extension on a VM
      effect: write
      questions:
      - How do I fix a broken SQL IaaS Agent extension on my VM?
      - Can I uninstall and reinstall the SQL IaaS extension in one step?
      instructions:
      - text: Redeploy the SQL IaaS extension on {sqlVirtualMachineName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Reinstall the SQL IaaS agent on VM {sqlVirtualMachineName}.
        slots:
          sqlVirtualMachineName: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'