Virtual Machines - Capture

Captures the VM by copying virtual hard disks of the VM and outputs a template that can be used to create similar VMs.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/capture?api-version=2024-07-01

URI Parameters

Name In Required Type Description
resourceGroupName
path True

string

The name of the resource group.

subscriptionId
path True

string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

vmName
path True

string

The name of the virtual machine.

api-version
query True

string

Client Api Version.

Request Body

Name Type Description
parameters

VirtualMachineCaptureParameters

Parameters supplied to the Capture Virtual Machine operation.

Responses

Name Type Description
200 OK

VirtualMachineCaptureResult

OK

202 Accepted

Accepted

Other Status Codes

CloudError

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation impersonate your user account

Examples

VirtualMachine_Capture_MaximumSet_Gen
VirtualMachine_Capture_MinimumSet_Gen

VirtualMachine_Capture_MaximumSet_Gen

Sample request

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/capture?api-version=2024-07-01

{
  "vhdPrefix": "aaaaaaaaa",
  "destinationContainerName": "aaaaaaa",
  "overwriteVhds": true
}

Sample response

{
  "$schema": "aaaaa",
  "contentVersion": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "parameters": {},
  "resources": [
    {}
  ],
  "id": "aaaaaaaaaaaaaaaaaaaaaaaa"
}
location: https://foo.com/operationstatus

VirtualMachine_Capture_MinimumSet_Gen

Sample request

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaa/capture?api-version=2024-07-01

{
  "vhdPrefix": "aaaaaaaaa",
  "destinationContainerName": "aaaaaaa",
  "overwriteVhds": true
}

Sample response

{}
location: https://foo.com/operationstatus

Definitions

Name Description
ApiError

Api error.

ApiErrorBase

Api error base.

CloudError

An error response from the Compute service.

InnerError

Inner error details.

VirtualMachineCaptureParameters

Parameters supplied to the Capture Virtual Machine operation.

VirtualMachineCaptureResult

Output of virtual machine capture operation.

ApiError

Api error.

Name Type Description
code

string

The error code.

details

ApiErrorBase[]

The Api error details

innererror

InnerError

The Api inner error

message

string

The error message.

target

string

The target of the particular error.

ApiErrorBase

Api error base.

Name Type Description
code

string

The error code.

message

string

The error message.

target

string

The target of the particular error.

CloudError

An error response from the Compute service.

Name Type Description
error

ApiError

Api error.

InnerError

Inner error details.

Name Type Description
errordetail

string

The internal error message or exception dump.

exceptiontype

string

The exception type.

VirtualMachineCaptureParameters

Parameters supplied to the Capture Virtual Machine operation.

Name Type Description
destinationContainerName

string

The destination container name.

overwriteVhds

boolean

Specifies whether to overwrite the destination virtual hard disk, in case of conflict.

vhdPrefix

string

The captured virtual hard disk's name prefix.

VirtualMachineCaptureResult

Output of virtual machine capture operation.

Name Type Description
$schema

string

the schema of the captured virtual machine

contentVersion

string

the version of the content

id

string

Resource Id

parameters

object

parameters of the captured virtual machine

resources

object[]

a list of resource items of the captured virtual machine