你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
VirtualMachinesOperations 类
- 继承
-
builtins.objectVirtualMachinesOperations
构造函数
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 磁盘的虚拟机,对于具有临时 OS 磁盘的虚拟机,虚拟机将重置为初始状态。 注意:保留旧 OS 磁盘取决于 OS 磁盘的 deleteOption 值。 如果 deleteOption 是分离的,旧 OS 磁盘将在重置映像后保留。 如果 deleteOption 为 delete,则会在重置映像后删除旧的 OS 磁盘。 在执行重置映像之前,应相应地更新 OS 磁盘的 deleteOption。 |
begin_restart |
重启虚拟机的操作。 |
begin_run_command |
在 VM 上运行命令。 |
begin_start |
启动虚拟机的操作。 |
begin_update |
更新虚拟机的操作。 |
generalize |
将虚拟机的 OS 状态设置为通用化。 建议在执行此操作之前对虚拟机进行 sysprep。 对于 Windows,请参阅 在 Azure 中创建通用化 VM 的托管映像。 对于 Linux,请参阅 如何创建虚拟机或 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- parameters
- VirtualMachineCaptureParameters 或 IO
提供给捕获虚拟机操作的参数。 是 VirtualMachineCaptureParameters 类型或 IO 类型。 必需。
- content_type
- str
Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- content_type
- str
Body 参数内容类型。 已知值为:“application/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 ARMPolling。 将此操作传入 False 以不进行轮询,或为个人轮询策略传入你自己的初始化轮询对象。
- polling_interval
- int
如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。
返回
LROPoller 的实例,返回 VirtualMachine 或 cls 的结果 (响应)
返回类型
例外
begin_deallocate
关闭虚拟机并释放计算资源。 无需为此虚拟机使用的计算资源付费。
begin_deallocate(resource_group_name: str, vm_name: str, *, hibernate: bool | None = None, **kwargs: Any) -> LROPoller[None]
参数
- hibernate
- bool
用于使虚拟机休眠的可选参数。 预览版) 中的 (功能。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- force_deletion
- bool
强制删除虚拟机的可选参数。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的继续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- install_patches_input
- VirtualMachineInstallPatchesParameters 或 IO
API 直接接收的 InstallPatches 的输入。 是 VirtualMachineInstallPatchesParameters 类型或 IO 类型。 必需。
- content_type
- str
正文参数内容类型。 已知值为:“application/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- skip_shutdown
- bool
用于请求非正常 VM 关闭的参数。 此标志的 True 值表示非正常关闭,而 false 指示否则关闭。 如果未指定,则此标志的默认值为 false。 默认值为 False。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 ARMPolling。 如果此操作不轮询,则传入 False,或者为个人轮询策略传入你自己的初始化轮询对象。
- polling_interval
- int
如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。
返回
LROPoller 的实例,返回 None 或 cls 的结果 (响应)
返回类型
例外
begin_reimage
重置映像 (升级操作系统) 没有临时 OS 磁盘的虚拟机,对于具有临时 OS 磁盘的虚拟机,虚拟机将重置为初始状态。 注意:保留旧 OS 磁盘取决于 OS 磁盘的 deleteOption 值。 如果 deleteOption 是分离的,旧 OS 磁盘将在重置映像后保留。 如果 deleteOption 为 delete,则会在重置映像后删除旧的 OS 磁盘。 在执行重置映像之前,应相应地更新 OS 磁盘的 deleteOption。
begin_reimage(resource_group_name: str, vm_name: str, parameters: _models.VirtualMachineReimageParameters | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> LROPoller[None]
参数
- parameters
- VirtualMachineReimageParameters 或 IO
提供给“重新映像虚拟机”操作的参数。 是 VirtualMachineReimageParameters 类型或 IO 类型。 默认值为 None。
- content_type
- str
正文参数内容类型。 已知值为:“application/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- content_type
- str
正文参数内容类型。 已知值为:“application/json”、“text/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 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]
参数
- content_type
- str
正文参数内容类型。 已知值为:“application/json”。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
- continuation_token
- str
用于从保存状态重启轮询的延续标记。
- polling
- bool 或 PollingMethod
默认情况下,轮询方法将为 ARMPolling。 如果此操作不轮询,则传入 False,或者为个人轮询策略传入你自己的初始化轮询对象。
- polling_interval
- int
如果没有 Retry-After 标头,则 LRO 操作的两次轮询之间的默认等待时间。
返回
LROPoller 的实例,返回 VirtualMachine 或 cls (响应的结果)
返回类型
例外
generalize
将虚拟机的 OS 状态设置为通用化。 建议在执行此操作之前对虚拟机进行 sysprep。 对于 Windows,请参阅 在 Azure 中创建通用化 VM 的托管映像。 对于 Linux,请参阅 如何创建虚拟机或 VHD 的映像。
generalize(resource_group_name: str, vm_name: str, **kwargs: Any) -> None
参数
- cls
- callable
将传递直接响应的自定义类型或函数
返回
无响应或 cls 的结果 (响应)
返回类型
例外
get
检索虚拟机的模型视图或实例视图的相关信息。
get(resource_group_name: str, vm_name: str, *, expand: str | InstanceViewTypes | None = None, **kwargs: Any) -> VirtualMachine
参数
- expand
- str 或 InstanceViewTypes
要应用于操作的 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
参数
- cls
- callable
将传递直接响应的自定义类型或函数
返回
VirtualMachineInstanceView 或 cls 的结果 (响应)
返回类型
例外
list
列出指定资源组中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。
list(resource_group_name: str, *, filter: str | None = None, expand: str | ExpandTypeForListVMs | None = None, **kwargs: Any) -> Iterable[VirtualMachine]
参数
- filter
- str
用于筛选响应中返回的 VM 的系统查询选项。 允许的值为“virtualMachineScaleSet/id”eq /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}”。 默认值为 None。
- expand
- str 或 ExpandTypeForListVMs
要应用于操作的 expand 表达式。 “instanceView”允许提取所有虚拟机的运行时状态,仅当指定了有效的$filter选项时,才能指定此状态。 “instanceView”默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
返回
一个迭代器,如 VirtualMachine 的实例或 cls 的结果 (响应)
返回类型
例外
list_all
列出指定订阅中的所有虚拟机。 使用响应中的 nextLink 属性获取虚拟机的下一页。
list_all(*, status_only: str | None = None, filter: str | None = None, expand: str | ExpandTypesForListVMs | None = None, **kwargs: Any) -> Iterable[VirtualMachine]
参数
- status_only
- str
statusOnly=true 允许提取订阅中所有虚拟机的运行时状态。 默认值为 None。
- filter
- str
用于筛选响应中返回的 VM 的系统查询选项。 允许的值为“virtualMachineScaleSet/id”eq /subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmssName}”。 默认值为 None。
- expand
- str 或 ExpandTypesForListVMs
要应用于操作的 expand 表达式。 “instanceView”允许提取所有虚拟机的运行时状态,仅当指定了有效的$filter选项时,才能指定此状态。 “instanceView”默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
返回
一个迭代器,如 VirtualMachine 的实例或 cls 的结果 (响应)
返回类型
例外
list_available_sizes
列出可以调整指定虚拟机大小的所有可用虚拟机大小。
list_available_sizes(resource_group_name: str, vm_name: str, **kwargs: Any) -> Iterable[VirtualMachineSize]
参数
- cls
- callable
将传递直接响应的自定义类型或函数
返回
一个迭代器,如 VirtualMachineSize 的实例或 cls 的结果 (响应)
返回类型
例外
list_by_location
获取指定位置的指定订阅下的所有虚拟机。
list_by_location(location: str, **kwargs: Any) -> Iterable[VirtualMachine]
参数
- 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
参数
- sas_uri_expiration_time_in_minutes
- int
值为 1 到 1440 分钟的 SAS URI 的过期持续时间(以分钟为单位)。 注意: 如果未指定,则会生成默认过期持续时间为 120 分钟的 SAS URI。 默认值为 None。
- cls
- callable
将传递直接响应的自定义类型或函数
返回
RetrieveBootDiagnosticsDataResult 或 cls 的结果 (响应)
返回类型
例外
simulate_eviction
用于模拟逐出现成虚拟机的操作。
simulate_eviction(resource_group_name: str, vm_name: str, **kwargs: Any) -> None
参数
- cls
- callable
将传递直接响应的自定义类型或函数
返回
无或 cls 的结果 (响应)
返回类型
例外
属性
models
models = <module 'azure.mgmt.compute.v2023_03_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\compute\\v2023_03_01\\models\\__init__.py'>