# 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 SqlMigrationManagementClient Sql Migration…
  version: 1.0.0
extends: openapi/microsoft-azure-sqlmigrationservices-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: 11
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a SQL migration service
      effect: read
      questions:
      - How do I look up the details of one Database Migration Service instance?
      - What state is my SQL migration service in right now?
      instructions:
      - text: Get SQL migration service {sqlMigrationServiceName} in resource group {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Show me the properties of migration service {sqlMigrationServiceName} in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create or update a SQL migration service
      effect: write
      questions:
      - How do I create a Database Migration Service for moving SQL databases to Azure?
      - Can I choose the region when I set up a SQL migration service?
      instructions:
      - text: Create SQL migration service {sqlMigrationServiceName} in {resourceGroupName} in region {location}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
          location: requestBody.location
      - text: Create or replace migration service {sqlMigrationServiceName} in {resourceGroupName} with tags {tags}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a SQL migration service
      effect: destructive
      questions:
      - How do I delete a Database Migration Service once my migrations are finished?
      - Can I remove a SQL migration service from a resource group?
      instructions:
      - text: Delete SQL migration service {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Remove the Database Migration Service {sqlMigrationServiceName} from resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a SQL migration service's tags
      effect: write
      questions:
      - Can I change the tags on an existing SQL migration service?
      - What can I patch on a Database Migration Service after it's created?
      instructions:
      - text: In subscription {subscriptionId}, set the tags on SQL migration service {sqlMigrationServiceName} in {resourceGroupName} to {tags}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
          tags: requestBody.tags
      - text: Retag migration service {sqlMigrationServiceName} in {resourceGroupName} with {tags}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL migration services in a resource group
      effect: read
      questions:
      - Which SQL migration services are in a given resource group?
      - How can I list Database Migration Services for just one resource group?
      instructions:
      - text: List SQL migration services in resource group {resourceGroupName} of subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show every Database Migration Service in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/listAuthKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Get integration runtime auth keys
      effect: read
      questions:
      - Where do I find the authentication keys to register a self-hosted integration runtime?
      - Can I retrieve the auth keys for my SQL migration service's integration runtime?
      instructions:
      - text: Get the integration runtime auth keys for migration service {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Show the self-hosted integration runtime keys for {sqlMigrationServiceName} in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/regenerateAuthKeys'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate integration runtime auth keys
      effect: destructive
      questions:
      - How do I rotate the authentication keys for a self-hosted integration runtime?
      - Can I regenerate just one of the two integration runtime auth keys?
      instructions:
      - text: Regenerate the auth keys for migration service {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Regenerate key {keyName} for migration service {sqlMigrationServiceName} in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          keyName: requestBody.keyName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/deleteNode'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete an integration runtime node
      effect: destructive
      questions:
      - How do I remove a node from the self-hosted integration runtime of a migration service?
      - Can I unregister a specific integration runtime node by name?
      instructions:
      - text: Delete integration runtime node {nodeName} from migration service {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
          nodeName: requestBody.nodeName
      - text: Remove node {nodeName} of runtime {integrationRuntimeName} from {sqlMigrationServiceName} in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          nodeName: requestBody.nodeName
          integrationRuntimeName: requestBody.integrationRuntimeName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/listMigrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List database migrations on a service
      effect: read
      questions:
      - Which database migrations are attached to my SQL migration service?
      - How can I see all the migrations running through one Database Migration Service?
      instructions:
      - text: List the database migrations on service {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Show every migration attached to {sqlMigrationServiceName} in resource group {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataMigration/sqlMigrationServices/{sqlMigrationServiceName}/listMonitoringData'].post
  update:
    x-apievangelist-phrasing:
      intent: Get integration runtime node monitoring data
      effect: read
      questions:
      - How do I check the health of the integration runtime nodes behind a migration service?
      - Can I see monitoring data for each registered integration runtime node?
      instructions:
      - text: Get the integration runtime node monitoring data for {sqlMigrationServiceName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
          subscriptionId: path.subscriptionId
      - text: Show the registered runtime nodes and their metrics for migration service {sqlMigrationServiceName} in {resourceGroupName}.
        slots:
          resourceGroupName: path.resourceGroupName
          sqlMigrationServiceName: path.sqlMigrationServiceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DataMigration/sqlMigrationServices'].get
  update:
    x-apievangelist-phrasing:
      intent: List SQL migration services in a subscription
      effect: read
      questions:
      - What SQL migration services do I have across my entire subscription?
      - Is there a subscription-wide list of Database Migration Services?
      instructions:
      - text: List all SQL migration services in subscription {subscriptionId}.
        slots:
          subscriptionId: path.subscriptionId
      - text: Show every Database Migration Service across the subscription.
      method: generated
      generated: '2026-09-26'