# 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 Database…
  version: 1.0.0
extends: openapi/microsoft-azure-databasemigrations-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: 20
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a MongoDB migration into a Cosmos DB RU account
      effect: read
      questions:
      - What is the status of my MongoDB migration into an Azure Cosmos DB for MongoDB RU account?
      - Can I look up one specific migration running against my RU-based Cosmos DB account?
      instructions:
      - text: Show migration {migration} into Cosmos DB RU account {account} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check progress of the RU Mongo migration {migration} on account {account}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a MongoDB migration into a Cosmos DB RU account
      effect: write
      questions:
      - How do I set up a migration from MongoDB into an Azure Cosmos DB for MongoDB RU account?
      - Can I change the settings of an existing migration targeting my RU Cosmos DB account?
      instructions:
      - text: Create migration {migration} into Cosmos DB RU account {account} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update the properties of RU Mongo migration {migration} on account {account}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a MongoDB migration on a Cosmos DB RU account
      effect: destructive
      questions:
      - Can I remove a finished migration resource from my Cosmos DB for MongoDB RU account?
      - Is there a way to force-delete a stuck migration on an RU-based Cosmos DB account?
      instructions:
      - text: Delete migration {migration} from Cosmos DB RU account {account} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force-delete RU Mongo migration {migration} on account {account}.
        slots:
          migration: path.migrationName
          account: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List MongoDB migrations on a Cosmos DB RU account
      effect: read
      questions:
      - Which migrations exist for my Azure Cosmos DB for MongoDB RU account?
      - Can I see every database migration pointed at one RU-based Cosmos DB account?
      instructions:
      - text: List all migrations into Cosmos DB RU account {account} in resource group {rg}, subscription {sub}.
        slots:
          account: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every RU Mongo migration on account {account}.
        slots:
          account: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/mongoClusters/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a MongoDB migration into a Cosmos DB vCore cluster
      effect: read
      questions:
      - What is the state of my MongoDB migration into a Cosmos DB for MongoDB vCore cluster?
      - Can I fetch a single migration running against my vCore Mongo cluster?
      instructions:
      - text: Show migration {migration} into vCore Mongo cluster {cluster} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Check progress of vCore migration {migration} on cluster {cluster}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/mongoClusters/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a MongoDB migration into a Cosmos DB vCore cluster
      effect: write
      questions:
      - How do I migrate a MongoDB database into an Azure Cosmos DB for MongoDB vCore cluster?
      - Can I modify a migration that targets my vCore Mongo cluster after creating it?
      instructions:
      - text: Create migration {migration} into vCore Mongo cluster {cluster} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update the properties of vCore migration {migration} on cluster {cluster}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/mongoClusters/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations/{migrationName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a MongoDB migration on a Cosmos DB vCore cluster
      effect: destructive
      questions:
      - Can I delete a migration resource from my Cosmos DB for MongoDB vCore cluster?
      - Is force deletion available for a migration on a vCore Mongo cluster?
      instructions:
      - text: Delete migration {migration} from vCore Mongo cluster {cluster} in resource group {rg}, subscription {sub}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force-delete vCore migration {migration} on cluster {cluster}.
        slots:
          migration: path.migrationName
          cluster: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/mongoClusters/{targetResourceName}/providers/Microsoft.DataMigration/databaseMigrations'].get
  update:
    x-apievangelist-phrasing:
      intent: List MongoDB migrations on a Cosmos DB vCore cluster
      effect: read
      questions:
      - Which migrations have been created against my Cosmos DB for MongoDB vCore cluster?
      - Can I list all database migrations for one vCore Mongo cluster?
      instructions:
      - text: List all migrations into vCore Mongo cluster {cluster} in resource group {rg}, subscription {sub}.
        slots:
          cluster: path.targetResourceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Show every vCore migration on cluster {cluster}.
        slots:
          cluster: path.targetResourceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{sqlDbInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database migration to Azure SQL Database
      effect: read
      questions:
      - How far along is my migration into an Azure SQL Database?
      - Can I expand the details of one migration operation into Azure SQL Database?
      instructions:
      - text: Show the migration into database {db} on Azure SQL server {server} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get migration details for {db} on SQL server {server}, expanding {expand}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
          expand: query.$expand
      - text: Look up migration operation {opid} for database {db} on SQL server {server}.
        slots:
          opid: query.migrationOperationId
          db: path.targetDbName
          server: path.sqlDbInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{sqlDbInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a database migration to Azure SQL Database
      effect: write
      questions:
      - How do I kick off a migration of a database into Azure SQL Database?
      - Can I update an existing migration resource that targets an Azure SQL Database?
      instructions:
      - text: Create a migration into database {db} on Azure SQL server {server} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Update the migration settings for target database {db} on SQL server {server}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{sqlDbInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a database migration to Azure SQL Database
      effect: destructive
      questions:
      - Can I delete the migration resource for a database on an Azure SQL server?
      - Is there a force option to remove an Azure SQL Database migration?
      instructions:
      - text: Delete the migration for database {db} on Azure SQL server {server} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Force-delete the SQL Database migration for {db} on server {server}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{sqlDbInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a running migration to Azure SQL Database
      effect: destructive
      questions:
      - How do I stop an ongoing migration into Azure SQL Database?
      - Can I cancel just one migration operation for an Azure SQL Database target?
      instructions:
      - text: Cancel the ongoing migration into database {db} on Azure SQL server {server} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          server: path.sqlDbInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Stop migration operation {opid} for database {db} on SQL server {server}.
        slots:
          opid: requestBody.migrationOperationId
          db: path.targetDbName
          server: path.sqlDbInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database migration to SQL Managed Instance
      effect: read
      questions:
      - What is the status of my database migration to Azure SQL Managed Instance?
      - Can I see expanded details for a migration into a managed instance?
      instructions:
      - text: Show the migration of database {db} to managed instance {mi} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get managed instance migration details for {db} on {mi}, expanding {expand}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
          expand: query.$expand
      - text: Look up migration operation {opid} for {db} on managed instance {mi}.
        slots:
          opid: query.migrationOperationId
          db: path.targetDbName
          mi: path.managedInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a database migration to SQL Managed Instance
      effect: write
      questions:
      - How do I create a new database migration to Azure SQL Managed Instance?
      - Which details do I provide to migrate a database onto a managed instance?
      instructions:
      - text: Create a migration of database {db} to managed instance {mi} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Start migrating {db} onto SQL Managed Instance {mi}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a migration to SQL Managed Instance
      effect: destructive
      questions:
      - Can I stop an in-progress database migration to Azure SQL Managed Instance?
      - How do I cancel a particular migration operation on a managed instance?
      instructions:
      - text: Cancel the in-progress migration of {db} to managed instance {mi} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Stop migration operation {opid} for {db} on managed instance {mi}.
        slots:
          opid: requestBody.migrationOperationId
          db: path.targetDbName
          mi: path.managedInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}/cutover'].post
  update:
    x-apievangelist-phrasing:
      intent: Cut over an online migration to SQL Managed Instance
      effect: write
      questions:
      - How do I complete the cutover of an online migration to SQL Managed Instance?
      - When my online migration to a managed instance has caught up, can I trigger the final switch?
      instructions:
      - text: Initiate cutover for the online migration of {db} to managed instance {mi} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          mi: path.managedInstanceName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Cut over migration operation {opid} for {db} on managed instance {mi}.
        slots:
          opid: requestBody.migrationOperationId
          db: path.targetDbName
          mi: path.managedInstanceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a database migration to SQL Server on an Azure VM
      effect: read
      questions:
      - What is the progress of my database migration to SQL Server on an Azure virtual machine?
      - Can I get expanded details for a migration into a SQL VM?
      instructions:
      - text: Show the migration of database {db} to SQL VM {vm} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Get SQL VM migration details for {db} on {vm}, expanding {expand}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
          expand: query.$expand
      - text: Look up migration operation {opid} for {db} on SQL VM {vm}.
        slots:
          opid: query.migrationOperationId
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Start a database migration to SQL Server on an Azure VM
      effect: write
      questions:
      - How do I start migrating a database to SQL Server running on an Azure VM?
      - Can I create a migration that targets a SQL virtual machine instead of a managed service?
      instructions:
      - text: Create a migration of database {db} to SQL VM {vm} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Start migrating {db} onto SQL virtual machine {vm}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop a migration to SQL Server on an Azure VM
      effect: destructive
      questions:
      - Can I stop an in-progress database migration to a SQL VM?
      - How do I cancel one migration operation running against a SQL virtual machine?
      instructions:
      - text: Cancel the in-progress migration of {db} to SQL VM {vm} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Stop migration operation {opid} for {db} on SQL VM {vm}.
        slots:
          opid: requestBody.migrationOperationId
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.SqlVirtualMachine/sqlVirtualMachines/{sqlVirtualMachineName}/providers/Microsoft.DataMigration/databaseMigrations/{targetDbName}/cutover'].post
  update:
    x-apievangelist-phrasing:
      intent: Cut over an online migration to SQL Server on an Azure VM
      effect: write
      questions:
      - How do I perform the final cutover of an online migration to a SQL VM?
      - Is it possible to trigger cutover for a specific migration operation on a SQL virtual machine?
      instructions:
      - text: Initiate cutover for the online migration of {db} to SQL VM {vm} in resource group {rg}, subscription {sub}.
        slots:
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
          rg: path.resourceGroupName
          sub: path.subscriptionId
      - text: Cut over migration operation {opid} for {db} on SQL VM {vm}.
        slots:
          opid: requestBody.migrationOperationId
          db: path.targetDbName
          vm: path.sqlVirtualMachineName
      method: generated
      generated: '2026-09-26'