VirtualMachinesOperations Class

Reference

VirtualMachinesOperations operations.

You should not instantiate this class directly. Instead, you should create a Client instance that instantiates it for you and attaches it as an attribute.

Constructor

VirtualMachinesOperations(client, config, serializer, deserializer)

Parameters

Name	Description
client Required	Client for service requests.
config Required	Configuration of service client.
serializer Required	An object model serializer.
deserializer Required	An object model deserializer.

Variables

Name	Description
models	Alias to model classes used in this operation group.

Methods

begin_add_data_disk	Attach a new or existing data disk to virtual machine. This operation can take a while to complete.
begin_apply_artifacts	Apply artifacts to virtual machine. This operation can take a while to complete.
begin_claim	Take ownership of an existing virtual machine This operation can take a while to complete.
begin_create_or_update	Create or replace an existing virtual machine. This operation can take a while to complete.
begin_delete	Delete virtual machine. This operation can take a while to complete.
begin_detach_data_disk	Detach the specified disk from the virtual machine. This operation can take a while to complete.
begin_redeploy	Redeploy a virtual machine This operation can take a while to complete.
begin_resize	Resize Virtual Machine. This operation can take a while to complete.
begin_restart	Restart a virtual machine. This operation can take a while to complete.
begin_start	Start a virtual machine. This operation can take a while to complete.
begin_stop	Stop a virtual machine This operation can take a while to complete.
begin_transfer_disks	Transfers all data disks attached to the virtual machine to be owned by the current user. This operation can take a while to complete.
begin_un_claim	Release ownership of an existing virtual machine This operation can take a while to complete.
get	Get virtual machine.
get_rdp_file_contents	Gets a string that represents the contents of the RDP file for the virtual machine.
list	List virtual machines in a given lab.
list_applicable_schedules	Lists the applicable start/stop schedules, if any.
update	Allows modifying tags of virtual machines. All other properties will be ignored.

begin_add_data_disk

Attach a new or existing data disk to virtual machine. This operation can take a while to complete.

begin_add_data_disk(resource_group_name: str, lab_name: str, name: str, data_disk_properties: '_models.DataDiskProperties', **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
data_disk_properties Required	DataDiskProperties Request body for adding a new or existing data disk to a virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_apply_artifacts

Apply artifacts to virtual machine. This operation can take a while to complete.

begin_apply_artifacts(resource_group_name: str, lab_name: str, name: str, artifacts: List['_models.ArtifactInstallProperties'] | None = None, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
artifacts Required	list[ArtifactInstallProperties] The list of artifacts to apply. Default value: None

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_claim

Take ownership of an existing virtual machine This operation can take a while to complete.

begin_claim(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_create_or_update

Create or replace an existing virtual machine. This operation can take a while to complete.

begin_create_or_update(resource_group_name: str, lab_name: str, name: str, lab_virtual_machine: '_models.LabVirtualMachine', **kwargs: Any) -> LROPoller['_models.LabVirtualMachine']

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
lab_virtual_machine Required	LabVirtualMachine A virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[LabVirtualMachine]	An instance of LROPoller that returns either LabVirtualMachine or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_delete

Delete virtual machine. This operation can take a while to complete.

begin_delete(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_detach_data_disk

Detach the specified disk from the virtual machine. This operation can take a while to complete.

begin_detach_data_disk(resource_group_name: str, lab_name: str, name: str, existing_lab_disk_id: str | None = None, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
existing_lab_disk_id Required	str Specifies the disk resource ID to detach from virtual machine. Default value: None

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_redeploy

Redeploy a virtual machine This operation can take a while to complete.

begin_redeploy(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_resize

Resize Virtual Machine. This operation can take a while to complete.

begin_resize(resource_group_name: str, lab_name: str, name: str, size: str | None = None, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
size Required	str Specifies the size of the virtual machine. Default value: None

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_restart

Restart a virtual machine. This operation can take a while to complete.

begin_restart(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_start

Start a virtual machine. This operation can take a while to complete.

begin_start(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_stop

Stop a virtual machine This operation can take a while to complete.

begin_stop(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_transfer_disks

Transfers all data disks attached to the virtual machine to be owned by the current user. This operation can take a while to complete.

begin_transfer_disks(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

begin_un_claim

Release ownership of an existing virtual machine This operation can take a while to complete.

begin_un_claim(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> LROPoller[None]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response
continuation_token	str A continuation token to restart a poller from a saved state.
polling	bool or PollingMethod True for ARMPolling, False for no polling, or a polling object for personal polling strategy
polling_interval	int Default waiting time between two polls for LRO operations if no Retry-After header is present.

Returns

Type	Description
LROPoller[None]	An instance of LROPoller that returns either None or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

get

Get virtual machine.

get(resource_group_name: str, lab_name: str, name: str, expand: str | None = None, **kwargs: Any) -> _models.LabVirtualMachine

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
expand Required	str Specify the $expand query. Example: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'. Default value: None

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response

Returns

Type	Description
LabVirtualMachine	LabVirtualMachine, or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

get_rdp_file_contents

Gets a string that represents the contents of the RDP file for the virtual machine.

get_rdp_file_contents(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> _models.RdpConnection

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response

Returns

Type	Description
RdpConnection	RdpConnection, or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

list

List virtual machines in a given lab.

list(resource_group_name: str, lab_name: str, expand: str | None = None, filter: str | None = None, top: int | None = None, orderby: str | None = None, **kwargs: Any) -> Iterable['_models.LabVirtualMachineList']

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
expand Required	str Specify the $expand query. Example: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'. Default value: None
filter Required	str The filter to apply to the operation. Example: '$filter=contains(name,'myName'). Default value: None
top Required	int The maximum number of resources to return from the operation. Example: '$top=10'. Default value: None
orderby Required	str The ordering expression for the results, using OData notation. Example: '$orderby=name desc'. Default value: None

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response

Returns

Type	Description
ItemPaged[LabVirtualMachineList]	An iterator like instance of either LabVirtualMachineList or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

list_applicable_schedules

Lists the applicable start/stop schedules, if any.

list_applicable_schedules(resource_group_name: str, lab_name: str, name: str, **kwargs: Any) -> _models.ApplicableSchedule

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response

Returns

Type	Description
ApplicableSchedule	ApplicableSchedule, or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

update

Allows modifying tags of virtual machines. All other properties will be ignored.

update(resource_group_name: str, lab_name: str, name: str, lab_virtual_machine: '_models.LabVirtualMachineFragment', **kwargs: Any) -> _models.LabVirtualMachine

Parameters

Name	Description
resource_group_name Required	str The name of the resource group.
lab_name Required	str The name of the lab.
name Required	str The name of the virtual machine.
lab_virtual_machine Required	LabVirtualMachineFragment A virtual machine.

Keyword-Only Parameters

Name	Description
cls	callable A custom type or function that will be passed the direct response

Returns

Type	Description
LabVirtualMachine	LabVirtualMachine, or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

Attributes

models

models = <module 'azure.mgmt.devtestlabs.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.10\\x64\\Lib\\site-packages\\azure\\mgmt\\devtestlabs\\models\\__init__.py'>

Share via

VirtualMachinesOperations Class

Constructor

Parameters

Variables

Methods

begin_add_data_disk

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_apply_artifacts

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_claim

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_create_or_update

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_delete

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_detach_data_disk

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_redeploy

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_resize

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_restart

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_start

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_stop

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_transfer_disks

Parameters

Keyword-Only Parameters

Returns

Exceptions

begin_un_claim

Parameters

Keyword-Only Parameters

Returns

Exceptions

get

Parameters

Keyword-Only Parameters

Returns

Exceptions

get_rdp_file_contents

Parameters

Keyword-Only Parameters

Returns