Share via

VirtualMachineScaleSetVMsOperations Class

  • Reference

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.

begin_deallocate(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_delete(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_perform_maintenance(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_power_off(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_redeploy(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_reimage(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_reimage_all(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_restart(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_start(resource_group_name: str, vm_scale_set_name: str, instance_id: str, **kwargs: Any) -> LROPoller[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
LROPoller[OperationStatusResponse]

An instance of LROPoller 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.

begin_update(resource_group_name: str, vm_scale_set_name: str, instance_id: str, parameters: _models.VirtualMachineScaleSetVM, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_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
LROPoller[VirtualMachineScaleSetVM]

An instance of LROPoller that returns either VirtualMachineScaleSetVM or the result of cls(response)

Exceptions

Type Description
HttpResponseError

get

Gets a virtual machine from a VM scale set.

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.

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) -> Iterable[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
ItemPaged[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'>