你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

VirtualMachinesOperations 类

警告

请勿直接实例化此类。

相反,应通过以下方式访问以下操作:

ComputeManagementClient

<xref:virtual_machines> 属性。

继承
builtins.object
VirtualMachinesOperations

构造函数

VirtualMachinesOperations(*args, **kwargs)

方法

begin_assess_patches

评估 VM 上的修补程序。

begin_capture

通过复制 VM 的虚拟硬盘来捕获 VM,并输出可用于创建类似 VM 的模板。

begin_convert_to_managed_disks

将虚拟机磁盘从基于 Blob 的磁盘转换为托管磁盘。 在调用此操作之前,必须停止解除分配虚拟机。

begin_create_or_update

用于创建或更新虚拟机的操作。 请注意,某些属性只能在创建虚拟机期间设置。

begin_deallocate

关闭虚拟机并释放计算资源。 无需为此虚拟机使用的计算资源付费。

begin_delete

用于删除虚拟机的操作。

begin_install_patches

在 VM 上安装修补程序。

begin_perform_maintenance

在虚拟机上执行维护的操作。

begin_power_off

关闭电源的操作 (停止) 虚拟机。 可以使用相同的预配资源重启虚拟机。 你仍需要为此虚拟机付费。

begin_reapply

重新应用虚拟机状态的操作。

begin_redeploy

关闭虚拟机,将其移动到新节点,然后重新打开它。

begin_reimage

将具有临时 OS 磁盘的虚拟机重置为初始状态。

begin_restart

重启虚拟机的操作。

begin_run_command

在 VM 上运行命令。

begin_start

启动虚拟机的操作。

begin_update

更新虚拟机的操作。

generalize

将虚拟机的 OS 状态设置为通用化。 建议在执行此操作之前对虚拟机进行 sysprep。 >>:code:<br>对于 Windows,请参阅 Create a managed image of a generalized VM in Azure <https://docs.microsoft.com/azure/virtual-machines/windows/capture-image-resource>_<<.:code:
For Linux, please refer to 如何创建虚拟机或 VHD
的映像。

get

检索虚拟机的模型视图或实例视图的相关信息。

instance_view

检索有关虚拟机的运行时状态的信息。

list

列出指定资源组中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。

list_all

列出指定订阅中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。

list_available_sizes

列出可以调整指定虚拟机大小的所有可用虚拟机大小。

list_by_location

获取指定位置的指定订阅下的所有虚拟机。

retrieve_boot_diagnostics_data

用于检索虚拟机启动诊断日志的 SAS URI 的操作。

simulate_eviction

模拟逐出现成虚拟机的操作。

begin_assess_patches

评估 VM 上的修补程序。

begin_assess_patches(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[VirtualMachineAssessPatchesResult]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

返回 VirtualMachineAssessPatchesResult 或 cls (响应结果的 LROPoller 实例)

返回类型

例外

begin_capture

通过复制 VM 的虚拟硬盘来捕获 VM,并输出可用于创建类似 VM 的模板。

begin_capture(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineCaptureParameters, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachineCaptureResult]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

parameters
VirtualMachineCaptureParametersIO
必需

提供给捕获虚拟机操作的参数。 是 VirtualMachineCaptureParameters 类型或 IO 类型。 必需。

content_type
str

Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 VirtualMachineCaptureResult 或 cls 的结果 (响应)

返回类型

例外

begin_convert_to_managed_disks

将虚拟机磁盘从基于 Blob 的磁盘转换为托管磁盘。 在调用此操作之前,必须停止解除分配虚拟机。

begin_convert_to_managed_disks(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_create_or_update

用于创建或更新虚拟机的操作。 请注意,某些属性只能在创建虚拟机期间设置。

begin_create_or_update(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachine, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachine]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

parameters
VirtualMachineIO
必需

提供给“创建虚拟机”操作的参数。 是 VirtualMachine 类型或 IO 类型。 必需。

content_type
str

Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 VirtualMachine 或 cls 的结果 (响应)

返回类型

例外

begin_deallocate

关闭虚拟机并释放计算资源。 无需为此虚拟机使用的计算资源付费。

begin_deallocate(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_delete

用于删除虚拟机的操作。

begin_delete(resource_group_name: str, vm_name: str, *, force_deletion: bool | None = None, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

force_deletion
bool

强制删除虚拟机的可选参数。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_install_patches

在 VM 上安装修补程序。

begin_install_patches(resource_group_name: str, vm_name: str, install_patches_input: _models.VirtualMachineInstallPatchesParameters, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachineInstallPatchesResult]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

install_patches_input
VirtualMachineInstallPatchesParametersIO
必需

API 直接接收的 InstallPatches 的输入。 是 VirtualMachineInstallPatchesParameters 类型或 IO 类型。 必需。

content_type
str

Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 VirtualMachineInstallPatchesResult 或 cls 的结果 (响应)

返回类型

例外

begin_perform_maintenance

在虚拟机上执行维护的操作。

begin_perform_maintenance(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_power_off

关闭电源的操作 (停止) 虚拟机。 可以使用相同的预配资源重启虚拟机。 你仍需要为此虚拟机付费。

begin_power_off(resource_group_name: str, vm_name: str, *, skip_shutdown: bool = False, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

skip_shutdown
bool

用于请求非正常 VM 关闭的参数。 此标志的 True 值指示非正常关闭,而 false 指示否则。 如果未指定,则此标志的默认值为 false。 默认值为 False。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_reapply

重新应用虚拟机状态的操作。

begin_reapply(resource_group_name: str, vm_name: str, **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_redeploy

关闭虚拟机,将其移动到新节点,然后重新打开它。

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

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_reimage

将具有临时 OS 磁盘的虚拟机重置为初始状态。

begin_reimage(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineReimageParameters | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[None]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

parameters
VirtualMachineReimageParametersIO
必需

提供给“重置虚拟机映像”操作的参数。 是 VirtualMachineReimageParameters 类型或 IO 类型。 默认值为 None。

content_type
str

Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_restart

重启虚拟机的操作。

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

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的继续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_run_command

在 VM 上运行命令。

begin_run_command(resource_group_name: str, vm_name: str, parameters: _models.RunCommandInput, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.RunCommandResult]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

parameters
RunCommandInputIO
必需

提供给 Run 命令操作的参数。 是 RunCommandInput 类型或 IO 类型。 必需。

content_type
str

Body 参数内容类型。 已知值为:“application/json”、“text/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的延续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 如果此操作不轮询,则传入 False,或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

返回 RunCommandResult 或 cls (响应结果的 LROPoller 实例)

返回类型

例外

begin_start

启动虚拟机的操作。

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

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的延续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 如果此操作不轮询,则传入 False,或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 None 或 cls 的结果 (响应)

返回类型

例外

begin_update

更新虚拟机的操作。

begin_update(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineUpdate, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[_models.VirtualMachine]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

parameters
VirtualMachineUpdateIO
必需

提供给更新虚拟机操作的参数。 是 VirtualMachineUpdate 类型还是 IO 类型。 必需。

content_type
str

正文参数内容类型。 已知值为:“application/json”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

continuation_token
str

用于从保存状态重启轮询的延续标记。

polling
boolPollingMethod

默认情况下,轮询方法将为 ARMPolling。 如果此操作不轮询,则传入 False,或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval
int

如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。

返回

LROPoller 的实例,返回 VirtualMachine 或 cls (响应的结果)

返回类型

例外

generalize

将虚拟机的 OS 状态设置为通用化。 建议在执行此操作之前对虚拟机进行 sysprep。 >>:code:<br>对于 Windows,请参阅 Create a managed image of a generalized VM in Azure <https://docs.microsoft.com/azure/virtual-machines/windows/capture-image-resource>_<<.:code:
For Linux, please refer to 如何创建虚拟机或 VHD
的映像。

generalize(resource_group_name: str, vm_name: str, **kwargs: Any) -> None

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

无响应或 cls 的结果 (响应)

返回类型

例外

get

检索虚拟机的模型视图或实例视图的相关信息。

get(resource_group_name: str, vm_name: str, *, expand: str | InstanceViewTypes | None = None, **kwargs: Any) -> VirtualMachine

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

expand
strInstanceViewTypes

要应用于操作的 expand 表达式。 “InstanceView”检索由平台管理的虚拟机的运行时属性快照,可以在控制平面操作外部更改。 “UserData”检索 UserData 属性作为用户在 VM 创建/更新操作期间提供的 VM 模型视图的一部分。 已知值为:“instanceView”和“userData”。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

返回

VirtualMachine 或 cls 的结果 (响应)

返回类型

例外

instance_view

检索有关虚拟机的运行时状态的信息。

instance_view(resource_group_name: str, vm_name: str, **kwargs: Any) -> VirtualMachineInstanceView

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

VirtualMachineInstanceView 或 cls 的结果 (响应)

返回类型

例外

list

列出指定资源组中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。

list(resource_group_name: str, **kwargs: Any) -> Iterable[VirtualMachine]

参数

resource_group_name
str
必需

资源组的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

一个迭代器,如 VirtualMachine 的实例或 cls 的结果 (响应)

返回类型

例外

list_all

列出指定订阅中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。

list_all(*, status_only: str | None = None, **kwargs: Any) -> Iterable[VirtualMachine]

参数

status_only
str

statusOnly=true 允许提取订阅中所有虚拟机的运行时状态。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

返回

一个迭代器,如 VirtualMachine 的实例或 cls 的结果 (响应)

返回类型

例外

list_available_sizes

列出可以调整指定虚拟机大小的所有可用虚拟机大小。

list_available_sizes(resource_group_name: str, vm_name: str, **kwargs: Any) -> Iterable[VirtualMachineSize]

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

一个迭代器,如 VirtualMachineSize 的实例或 cls 的结果 (响应)

返回类型

例外

list_by_location

获取指定位置的指定订阅下的所有虚拟机。

list_by_location(location: str, **kwargs: Any) -> Iterable[VirtualMachine]

参数

location
str
必需

查询订阅下的虚拟机的位置。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

一个迭代器,如 VirtualMachine 的实例或 cls 的结果 (响应)

返回类型

例外

retrieve_boot_diagnostics_data

用于检索虚拟机启动诊断日志的 SAS URI 的操作。

retrieve_boot_diagnostics_data(resource_group_name: str, vm_name: str, *, sas_uri_expiration_time_in_minutes: int | None = None, **kwargs: Any) -> RetrieveBootDiagnosticsDataResult

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

sas_uri_expiration_time_in_minutes
int

值为 1 到 1440 分钟的 SAS URI 的过期持续时间(以分钟为单位)。 <br>:code:>><<<br>注意:如果未指定,将生成默认过期持续时间为 120 分钟的 SAS URI。 默认值为 None。

cls
callable

将传递直接响应的自定义类型或函数

返回

RetrieveBootDiagnosticsDataResult 或 cls 的结果 (响应)

返回类型

例外

simulate_eviction

模拟逐出现成虚拟机的操作。

simulate_eviction(resource_group_name: str, vm_name: str, **kwargs: Any) -> None

参数

resource_group_name
str
必需

资源组的名称。 必需。

vm_name
str
必需

虚拟机的名称。 必需。

cls
callable

将传递直接响应的自定义类型或函数

返回

无响应或 cls 的结果 (响应)

返回类型

例外

属性

models

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