VirtualMachineScaleSetVMsOperations Class

Warning

DO NOT instantiate this class directly.

Instead, you should access the following operations through

ComputeManagementClient's

<xref:virtual_machine_scale_set_vms> attribute.

Inheritance

builtins.object

VirtualMachineScaleSetVMsOperations

Constructor

VirtualMachineScaleSetVMsOperations(*args, **kwargs)

Methods

begin_deallocate	Deallocates a specific virtual machine in a VM scale set. Shuts down the virtual machine and releases the compute resources it uses. You are not billed for the compute resources of this virtual machine once it is deallocated.
begin_delete	Deletes a virtual machine from a VM scale set.
begin_perform_maintenance	Performs maintenance on a virtual machine in a VM scale set.
begin_power_off	Power off (stop) a virtual machine in a VM scale set. Note that resources are still attached and you are getting charged for the resources. Instead, use deallocate to release resources and avoid charges.
begin_redeploy	Shuts down the virtual machine in the virtual machine scale set, moves it to a new node, and powers it back on.
begin_reimage	Reimages (upgrade the operating system) a specific virtual machine in a VM scale set.
begin_reimage_all	Allows you to re-image all the disks ( including data disks ) in the a VM scale set instance. This operation is only supported for managed disks.
begin_restart	Restarts a virtual machine in a VM scale set.
begin_start	Starts a virtual machine in a VM scale set.
begin_update	Updates a virtual machine of a VM scale set.
get	Gets a virtual machine from a VM scale set.
get_instance_view	Gets the status of a virtual machine from a VM scale set.
list	Gets a list of all virtual machines in a VM scale sets.

begin_deallocate

Deallocates a specific virtual machine in a VM scale set. Shuts down the virtual machine and releases the compute resources it uses. You are not billed for the compute resources of this virtual machine once it is deallocated.

async begin_deallocate(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_delete

Deletes a virtual machine from a VM scale set.

async begin_delete(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_perform_maintenance

Performs maintenance on a virtual machine in a VM scale set.

async begin_perform_maintenance(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_power_off

Power off (stop) a virtual machine in a VM scale set. Note that resources are still attached and you are getting charged for the resources. Instead, use deallocate to release resources and avoid charges.

async begin_power_off(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_redeploy

Shuts down the virtual machine in the virtual machine scale set, moves it to a new node, and powers it back on.

async begin_redeploy(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_reimage

Reimages (upgrade the operating system) a specific virtual machine in a VM scale set.

async begin_reimage(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_reimage_all

Allows you to re-image all the disks ( including data disks ) in the a VM scale set instance. This operation is only supported for managed disks.

async begin_reimage_all(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_restart

Restarts a virtual machine in a VM scale set.

async begin_restart(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_start

Starts a virtual machine in a VM scale set.

async begin_start(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> AsyncLROPoller[OperationStatusResponse]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

begin_update

Updates a virtual machine of a VM scale set.

async begin_update(resource_group_name: str, vm_scale_set_name: str, instance_id: str, parameters: _models.VirtualMachineScaleSetVM, *, content_type: str = 'application/json', **kwargs: Any) -> AsyncLROPoller[_models.VirtualMachineScaleSetVM]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set where the extension should be create or updated. Required.
instance_id Required	str The instance ID of the virtual machine. Required.
parameters Required	VirtualMachineScaleSetVM or IO[bytes] Parameters supplied to the Update Virtual Machine Scale Sets VM operation. Is either a VirtualMachineScaleSetVM type or a IO[bytes] type. Required.

Returns

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

Exceptions

Type	Description
HttpResponseError

get

Gets a virtual machine from a VM scale set.

async get(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> VirtualMachineScaleSetVM

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

Type	Description
VirtualMachineScaleSetVM	VirtualMachineScaleSetVM or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

get_instance_view

Gets the status of a virtual machine from a VM scale set.

async get_instance_view(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> VirtualMachineScaleSetVMInstanceView

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
vm_scale_set_name Required	str The name of the VM scale set. Required.
instance_id Required	str The instance ID of the virtual machine. Required.

Returns

Type	Description
VirtualMachineScaleSetVMInstanceView	VirtualMachineScaleSetVMInstanceView or the result of cls(response)

Exceptions

Type	Description
HttpResponseError

list

Gets a list of all virtual machines in a VM scale sets.

list(resource_group_name: str, virtual_machine_scale_set_name: str, *, filter: str | None = None, select: str | None = None, expand: str | None = None, **kwargs: Any) -> AsyncIterable[VirtualMachineScaleSetVM]

Parameters

Name	Description
resource_group_name Required	str The name of the resource group. Required.
virtual_machine_scale_set_name Required	str The name of the VM scale set. Required.

Keyword-Only Parameters

Name	Description
filter	str The filter to apply to the operation. Allowed values are 'startswith(instanceView/statuses/code, 'PowerState') eq true', 'properties/latestModelApplied eq true', 'properties/latestModelApplied eq false'. Default value is None.
select	str The list parameters. Allowed values are 'instanceView', 'instanceView/statuses'. Default value is None.
expand	str The expand expression to apply to the operation. Allowed values are 'instanceView'. Default value is None.

Returns

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

Exceptions

Type	Description
HttpResponseError

Attributes

models

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