ComputeInstance 类

在 Azure 机器学习中管理基于云的经过优化的 ML 开发环境。

Azure 机器学习计算实例是云中完全配置和托管的开发环境,针对机器学习开发工作流进行了优化。 ComputeInstance 通常用于创建开发环境,或用作开发和测试的训练和推理的计算目标。 借助 ComputeInstance,可以在工作区中完全集成的笔记本体验中创作、训练和部署模型。 有关详细信息,请参阅什么是 Azure 机器学习计算实例?

类 ComputeTarget 构造函数。

检索与提供的工作区关联的 Compute 对象的云表示形式。 返回与检索的 Compute 对象的特定类型对应的子类的实例。

继承
ComputeInstance

构造函数

ComputeInstance(workspace, name)

参数

workspace
Workspace
必需

包含要检索的 Compute 对象的工作区对象。

name
str
必需

要检索的 Compute 对象的 的名称。

方法

delete

从 ComputeInstance 对象的关联工作区中删除该对象。

deserialize

将 JSON 对象转换为 ComputeInstance 对象。

如果提供的工作区不是与 ComputeInstance 关联的工作区,则此操作将失败。

detach

ComputeInstance 对象不支持分离。 请改用 delete

get

返回 ComputeInstance 对象。

get_active_runs

为此计算返回运行的生成器。

get_docs_url

此类的文档的 URL。

get_status

检索 ComputeInstance 的当前详细状态。

provisioning_configuration

创建配置对象以预配 ComputeInstance 目标。

refresh_state

对对象属性执行就地更新。

此方法根据相应云对象的当前状态更新属性。 这主要用于计算状态的手动轮询。

restart

重启 ComputeInstance。

serialize

将此 ComputeInstance 对象转换为 JSON 序列化字典。

start

启动 ComputeInstance。

stop

停止 ComputeInstance。

supported_vmsizes

列出区域中支持的 VM 大小。

wait_for_completion

等待 ComputeInstance 完成预配。

delete

从 ComputeInstance 对象的关联工作区中删除该对象。

delete(wait_for_completion=False, show_output=False)

参数

wait_for_completion
默认值: False
show_output
默认值: False

例外

注解

如果此对象是通过 Azure ML 创建的,则相应的基于云的对象也将被删除。 如果此对象是在外部创建的,并且仅附加到工作区,则将引发异常,并且不会更改任何内容。

deserialize

将 JSON 对象转换为 ComputeInstance 对象。

如果提供的工作区不是与 ComputeInstance 关联的工作区,则此操作将失败。

static deserialize(workspace, object_dict)

参数

workspace
Workspace
必需

与 ComputeInstance 对象关联的工作区对象。

object_dict
dict
必需

要转换为 ComputeInstance 对象的 JSON 对象。

返回

提供的 JSON 对象的 ComputeInstance 表示形式。

返回类型

例外

detach

ComputeInstance 对象不支持分离。 请改用 delete

detach()

例外

不支持此操作。

get

返回 ComputeInstance 对象。

get()

返回

提供的 JSON 对象的 ComputeInstance 表示形式。

返回类型

例外

get_active_runs

为此计算返回运行的生成器。

get_active_runs(type=None, tags=None, properties=None, status=None)

参数

type
str
默认值: None

按提供的类型筛选运行的返回的生成器。 请参阅 add_type_provider,了解如何创建运行类型。

tags
strdict
默认值: None

按 "tag" 或 {"tag": "value"} 筛选运行

properties
strdict
默认值: None

按 "property" 或 {"property": "value"} 筛选运行

status
str
默认值: None

运行状态可以是“正在运行”或“已排队”。

返回

azureml._restclient.models.RunDto 的生成器

返回类型

<xref:builtin.generator>

例外

get_docs_url

此类的文档的 URL。

get_docs_url()

返回

URL

返回类型

str

例外

get_status

检索 ComputeInstance 的当前详细状态。

get_status()

返回

计算的详细状态对象

返回类型

例外

provisioning_configuration

创建配置对象以预配 ComputeInstance 目标。

static provisioning_configuration(vm_size='', ssh_public_access=False, admin_user_ssh_public_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, assigned_user_object_id=None, assigned_user_tenant_id=None)

参数

vm_size
str
必需

代理 VM 的大小。 此处提供了更多详细信息:https://aka.ms/azureml-vm-details。 请注意,并非所有大小都适用于所有区域,如上一个链接中所述。 默认为 Standard_NC6。

ssh_public_access
bool
默认值: False

指示公共 SSH 端口的状态。 可能的值包括:

  • False - 公共 SSH 端口已关闭。
  • True - 公共 SSH 端口已打开。
admin_user_ssh_public_key
str
默认值: None

管理员用户帐户的 SSH 公钥。

vnet_resourcegroup_name
str
默认值: None

虚拟网络所在的资源组的名称。

vnet_name
str
默认值: None

虚拟网络的名称。

subnet_name
str
默认值: None

vnet 内子网的名称。

tags
dict[str, str]
默认值: None

要与计算对象关联的键值标记的可选字典。

description
str
默认值: None

计算对象的可选说明。

assigned_user_object_id
str
默认值: None

分配的用户的 AAD 对象 ID(预览)。

assigned_user_tenant_id
str
默认值: None

分配的用户的 AAD 租户 ID(预览)。

返回

创建计算对象时要使用的配置对象。

返回类型

例外

refresh_state

对对象属性执行就地更新。

此方法根据相应云对象的当前状态更新属性。 这主要用于计算状态的手动轮询。

refresh_state()

例外

restart

重启 ComputeInstance。

restart(wait_for_completion=False, show_output=False)

参数

wait_for_completion
bool
默认值: False

等待状态更新的布尔值。 默认为 False。

show_output
bool
默认值: False

执行布尔运算以提供更详细的输出。 默认为 False。

返回

返回类型

例外

azureml.exceptions.ComputeTargetException:

serialize

将此 ComputeInstance 对象转换为 JSON 序列化字典。

serialize()

返回

此 ComputeInstance 对象的 JSON 表示形式。

返回类型

例外

start

启动 ComputeInstance。

start(wait_for_completion=False, show_output=False)

参数

wait_for_completion
bool
默认值: False

是否等待状态更新。 默认为 False。

show_output
bool
默认值: False

是否提供更详细的输出。 默认为 False。

返回

返回类型

例外

stop

停止 ComputeInstance。

stop(wait_for_completion=False, show_output=False)

参数

wait_for_completion
bool
默认值: False

是否等待状态更新。 默认为 False。

show_output
bool
默认值: False

是否提供更详细的输出。 默认为 False。

返回

返回类型

例外

supported_vmsizes

列出区域中支持的 VM 大小。

static supported_vmsizes(workspace, location=None)

参数

workspace
Workspace
必需

工作区。

location
str
默认值: None

实例的位置。 如果未指定,则默认值为工作区位置。

返回

区域中支持的 VM 大小列表,其中包含 VM、VCPU 和 RAM 的名称。

返回类型

例外

wait_for_completion

等待 ComputeInstance 完成预配。

wait_for_completion(show_output=False, is_delete_operation=False)

参数

show_output
bool
默认值: False

是否提供更详细的输出。 默认为 False。

is_delete_operation
bool
默认值: False

指示操作是否用于删除。

例外