Adding optional target subscription Id parameter in order to enable cross-subscription movement (#25127)

* Adding optional target subscription Id parameter in order to enable cross subscription db move/copy.

* Adding changed to ChangeLog.md file.

* Generating help files.

* Adding tests for cross subscription functionality.

---------

Co-authored-by: jovancevic123 <[email protected]>

Author: jovancevic123

src/Sql/Sql.Test/ScenarioTests/ManagedDatabaseMoveCopyTests.cs

@@ -32,6 +32,12 @@ public void TestManagedDatabaseMove()
             TestRunner.RunTestScript("Test-ManagedDatabaseMove");
         }
 
+        [Fact]
+        [Trait(Category.AcceptanceType, Category.LiveOnly)]
+        public void TestCrossSubscriptionManagedDatabaseMove()
+        {
+            TestRunner.RunTestScript("Test-CrossSubscriptionManagedDatabaseMove");
+        }
 
         [Fact]
         [Trait(Category.AcceptanceType, Category.CheckIn)]
@@ -46,7 +52,13 @@ public void TestManagedDatabaseCopy()
         {
             TestRunner.RunTestScript("Test-ManagedDatabaseCopy");
         }
-
+        
+        [Fact]
+        [Trait(Category.AcceptanceType, Category.LiveOnly)]
+        public void TestCrossSubscriptionManagedDatabaseCopy()
+        {
+            TestRunner.RunTestScript("Test-CrossSubscriptionManagedDatabaseCopy");
+        }
 
         [Fact]
         [Trait(Category.AcceptanceType, Category.CheckIn)]

src/Sql/Sql.Test/ScenarioTests/ManagedDatabaseMoveCopyTests.ps1

@@ -136,6 +136,99 @@ function Test-ManagedDatabaseMove
 	}
 }
 
+function Test-CrossSubscriptionManagedDatabaseMove
+{
+	$sourceRGName = "source-rg-name"
+	$targetRGName = "target-rg-name"
+	$sourceInstanceName = "source-mi-name"
+	$targetInstanceName = "target-mi-name"
+	$targetSubscriptionId = "0000-0000-0000-0000"
+	$managedDatabaseName = "database-name"
+
+	try
+	{
+		Move-AzSqlInstanceDatabase `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		$moveOperation = Get-AzSqlInstanceDatabaseMoveOperation `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-OnlyLatestPerDatabase
+
+		Assert-NotNull $moveOperation
+		Assert-AreEqual $moveOperation.TargetManagedInstanceName $targetInstanceName
+		Assert-AreEqual $moveOperation.SourceManagedInstanceName $sourceInstanceName
+		Assert-AreEqual $moveOperation.SourceDatabaseName $managedDatabaseName
+		Assert-AreEqual $moveOperation.OperationMode "Move"
+
+		while ($moveOperation.isCancellable -eq $false) {
+			Start-TestSleep -Seconds 30
+
+			$moveOperation = Get-AzSqlInstanceDatabaseMoveOperation `
+				-ResourceGroupName $sourceRGName `
+				-InstanceName $sourceInstanceName `
+				-Name $managedDatabaseName `
+				-OnlyLatestPerDatabase
+		}
+
+		Stop-AzSqlInstanceDatabaseMove `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		Wait-ForOperationToSucceed `
+			-rgName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		Move-AzSqlInstanceDatabase `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		Wait-ForOperationToSucceed `
+			-rgName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		Complete-AzSqlInstanceDatabaseMove `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName `
+			-Force
+				
+		Wait-ForOperationToSucceed `
+			-rgName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		Assert-Throws { 
+			Get-AzSqlInstanceDatabase `
+				-ResourceGroupName $sourceRGName `
+				-InstanceName $sourceInstanceName `
+				-Name $managedDatabaseName
+		}
+	}
+	finally
+	{
+	}
+}
+
 function Test-ManagedDatabaseMovePiping
 {
 	$sourceRg = Create-ResourceGroupForTest
@@ -478,6 +571,99 @@ function Test-ManagedDatabaseCopy
 	}
 }
 
+function Test-CrossSubscriptionManagedDatabaseCopy
+{
+	$sourceRGName = "source-rg-name"
+	$targetRGName = "target-rg-name"
+	$sourceInstanceName = "source-mi-name"
+	$targetInstanceName = "target-mi-name"
+	$targetSubscriptionId = "0000-0000-0000-0000"
+	$managedDatabaseName = "database-name"
+
+	try
+	{
+		Copy-AzSqlInstanceDatabase `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		$CopyOperation = Get-AzSqlInstanceDatabaseCopyOperation `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-OnlyLatestPerDatabase
+
+		Assert-NotNull $CopyOperation
+		Assert-AreEqual $CopyOperation.TargetManagedInstanceName $targetInstanceName
+		Assert-AreEqual $CopyOperation.SourceManagedInstanceName $sourceInstanceName
+		Assert-AreEqual $CopyOperation.SourceDatabaseName $managedDatabaseName
+		Assert-AreEqual $CopyOperation.OperationMode "Copy"
+
+		while ($CopyOperation.isCancellable -eq $false) {
+			Start-TestSleep -Seconds 30
+
+			$CopyOperation = Get-AzSqlInstanceDatabaseCopyOperation `
+				-ResourceGroupName $sourceRGName `
+				-InstanceName $sourceInstanceName `
+				-Name $managedDatabaseName `
+				-OnlyLatestPerDatabase
+		}
+
+		Stop-AzSqlInstanceDatabaseCopy `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		Wait-ForCopyOperationToSucceed `
+			-rgName $sourceRGName `
+			-instanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		Copy-AzSqlInstanceDatabase `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+
+		Wait-ForCopyOperationToSucceed `
+			-rgName $sourceRGName `
+			-instanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		Complete-AzSqlInstanceDatabaseCopy `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName `
+			-TargetSubscriptionId $targetSubscriptionId `
+			-TargetInstanceName $targetInstanceName `
+			-TargetResourceGroupName $targetRGName
+				
+		Wait-ForCopyOperationToSucceed `
+			-rgName $sourceRGName `
+			-instanceName $sourceInstanceName `
+			-databaseName $managedDatabaseName
+
+		$dbOnSource = Get-AzSqlInstanceDatabase `
+			-ResourceGroupName $sourceRGName `
+			-InstanceName $sourceInstanceName `
+			-Name $managedDatabaseName
+
+		Assert-NotNull $dbOnSource
+
+	}
+	finally
+	{
+	}
+}
+
 function Test-ManagedDatabaseCopyPiping
 {
 	$sourceRg = Create-ResourceGroupForTest