Labs - Import Virtual Machine

Import a virtual machine into a different lab. This operation can take a while to complete.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{name}/importVirtualMachine?api-version=2018-09-15

URI Parameters

Name In Required Type Description
name
path True

string

The name of the lab.

resourceGroupName
path True

string

The name of the resource group.

subscriptionId
path True

string

The subscription ID.

api-version
query True

string

Client API version.

Request Body

Name Type Description
destinationVirtualMachineName

string

The name of the virtual machine in the destination lab

sourceVirtualMachineResourceId

string

The full resource ID of the virtual machine to be imported.

Responses

Name Type Description
200 OK

OK

202 Accepted

Accepted

Other Status Codes

CloudError

BadRequest

Security

azure_auth

OAuth2 Implicit Grant

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Access Microsoft Azure

Examples

Labs_ImportVirtualMachine

Sample Request

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/importVirtualMachine?api-version=2018-09-15

{
  "sourceVirtualMachineResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{otherResourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}",
  "destinationVirtualMachineName": "{vmName}"
}

Sample Response

location: https://management.azure.com/subscriptions/{subscriptionId}/resourceGroup/{resourceGroupName}/providers/Microsoft.DevTestLabs/locations/{location}

Definitions

Name Description
CloudError

Error from a REST request.

CloudErrorBody

Body of an error from a REST request.

ImportLabVirtualMachineRequest

This represents the payload required to import a virtual machine from a different lab into the current one

CloudError

Error from a REST request.

Name Type Description
error

CloudErrorBody

The cloud error that occurred

CloudErrorBody

Body of an error from a REST request.

Name Type Description
code

string

The error code.

details

CloudErrorBody[]

Inner errors.

message

string

The error message.

target

string

The error target.

ImportLabVirtualMachineRequest

This represents the payload required to import a virtual machine from a different lab into the current one

Name Type Description
destinationVirtualMachineName

string

The name of the virtual machine in the destination lab

sourceVirtualMachineResourceId

string

The full resource ID of the virtual machine to be imported.