ComputeInstance Класс

Управляет облачной оптимизированной средой разработки машинного обучения в Машинном обучении Azure.

Вычислительный экземпляр Машинного обучения Azure — это полностью настраиваемая и управляемая среда разработки в облаке, оптимизированная для рабочих процессов разработки машинного обучения. Класс ComputeInstance обычно используется для создания среды разработки или в качестве целевого объекта вычислений для обучения и вывода при разработке и тестировании. С помощью ComputeInstance вы можете создавать, обучать и развертывать модели в полностью интегрированной записной книжке в рабочей области. Дополнительные сведения см. в статье Что такое вычислительный экземпляр Машинного обучения Azure?.

Конструктор ComputeTarget класса.

Получение облачного представления вычислительного объекта, связанного с предоставленной рабочей областью. Возвращает экземпляр дочернего класса, соответствующий конкретному типу извлеченного объекта Compute.

Наследование

ComputeTarget

ComputeInstance

Конструктор

ComputeInstance(workspace, name)

Параметры

Имя	Описание
workspace Обязательно	Workspace Объект рабочей области, содержащий извлекаемый объект вычислений.
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	Список поддерживаемых размеров виртуальных машин в регионе.
wait_for_completion	Время ожидания до завершения подготовки объекта ComputeInstance.

delete

Удаление объекта ComputeInstance из связанной с ним рабочей области.

delete(wait_for_completion=False, show_output=False)

Параметры

Имя	Описание
wait_for_completion	Default value: False
show_output	Default value: False

Исключения

Тип	Описание
ComputeTargetException

Комментарии

Если этот объект был создан с помощью Машинного обучения Microsoft Azure, будут удалены и соответствующие облачные объекты. Если этот объект был создан во внешней среде и просто подключен к рабочей области, исключение генерируется, ничего не изменяя.

deserialize

Преобразование объекта JSON в объект ComputeInstance.

Возникает ошибка, если указана не та рабочая область, с которой связан объект ComputeInstance.

static deserialize(workspace, object_dict)

Параметры

Имя	Описание
workspace Обязательно	Workspace Объект рабочей области, с которым связан объект ComputeInstance.
object_dict Обязательно	dict Объект JSON, преобразуемый в объект ComputeInstance.

Возвращаемое значение

Тип	Описание
ComputeInstance	Представление ComputeInstance указанного объекта JSON.

Исключения

Тип	Описание
ComputeTargetException

detach

Окончательное удаление не поддерживается для объекта ComputeInstance. Взамен рекомендуется использовать delete.

detach()

Исключения

Тип	Описание
ComputeTargetException	Операция не поддерживается.

get

Возвращает объект ComputeInstance.

get()

Возвращаемое значение

Тип	Описание
ComputeInstance	Представление ComputeInstance указанного объекта JSON.

Исключения

Тип	Описание
ComputeTargetException

get_active_runs

Возвращает генератор запусков для этого вычисления.

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

Параметры

Имя	Описание
type	str Фильтрует возвращенный генератор запусков по предоставленному типу. См. раздел add_type_provider для создания типов запуска. Default value: None
tags	str или dict Для запуска фильтрации используется "метка" или {"метка": "значение"} Default value: None
properties	str или dict Для фильтрации используется "свойство" или {"свойство": "значение"} Default value: None
status	str Выполнение может иметь состояние "Выполняется" или "В очереди". Default value: None

Возвращаемое значение

Тип	Описание
<xref:builtin.generator>	Генератор azureml._restclient.models.RunDto

Исключения

Тип	Описание
ComputeTargetException

get_docs_url

URL-адрес документации для этого класса.

get_docs_url()

Возвращаемое значение

Тип	Описание
str	url

Исключения

Тип	Описание
ComputeTargetException

get_status

Извлекает текущее подробное состояние объекта ComputeInstance.

get_status()

Возвращаемое значение

Тип	Описание
ComputeInstanceStatus	Подробный объект состояния для вычисления

Исключения

Тип	Описание
ComputeTargetException

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 Размер виртуальных машин агента. Дополнительные сведения приведены в https://aka.ms/azureml-vm-details. Обратите внимание, что все размеры доступны не во всех регионах (см. предыдущую ссылку). Значение по умолчанию — Standard_NC6.
ssh_public_access	bool Указывает состояние общедоступного порта SSH. Возможны следующие значения: False означает, что общедоступный порт SSH закрыт. True означает, что общедоступный порт SSH открыт. Default value: False
admin_user_ssh_public_key	str Открытый ключ SSH учетной записи администратора. Default value: None
vnet_resourcegroup_name	str Имя группы ресурсов, в которой находится виртуальная сеть. Default value: None
vnet_name	str Имя виртуальной сети. Default value: None
subnet_name	str Имя подсети в виртуальной сети. Default value: None
tags	dict[str, str] Необязательный словарь тегов значений ключа, связываемый с объектом вычисления. Default value: None
description	str Необязательное описание объекта вычисления. Default value: None
assigned_user_object_id	str Идентификатор объекта Azure Active Directory назначенного пользователя (предварительная версия). Default value: None
assigned_user_tenant_id	str Идентификатор клиента Azure Active Directory назначенного пользователя (предварительная версия). Default value: None

Возвращаемое значение

Тип	Описание
ComputeInstanceProvisioningConfiguration	Объект конфигурации, который нужно использовать при создании объекта вычислений.

Исключения

Тип	Описание
ComputeTargetException

refresh_state

Выполнение обновлений свойств объекта на месте.

Этот метод обновляет свойства согласно текущему состоянию соответствующего облачного объекта. Это полезно в первую очередь при опросе состояния вычислений вручную.

refresh_state()

Исключения

Тип	Описание
ComputeTargetException

restart

Перезапуск ComputeInstance.

restart(wait_for_completion=False, show_output=False)

Параметры

Имя	Описание
wait_for_completion	bool Логическое значение для ожидания обновления состояния. Значение по умолчанию — False. Default value: False
show_output	bool Логическое значение для предоставления более подробных выходных данных. Значение по умолчанию — False. Default value: False

Возвращаемое значение

Тип	Описание
None	None

Исключения

Тип	Описание
azureml.exceptions.ComputeTargetException:

serialize

Преобразование этого объекта ComputeInstance в сериализованный словарь JSON.

serialize()

Возвращаемое значение

Тип	Описание
dict	Представление JSON этого объекта ComputeInstance.

Исключения

Тип	Описание
ComputeTargetException

start

Запуск ComputeInstance.

start(wait_for_completion=False, show_output=False)

Параметры

Имя	Описание
wait_for_completion	bool Нужно ли ожидать обновления состояния. Значение по умолчанию — False. Default value: False
show_output	bool Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False. Default value: False

Возвращаемое значение

Тип	Описание
None	None

Исключения

Тип	Описание
ComputeTargetException

stop

Остановка ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Параметры

Имя	Описание
wait_for_completion	bool Нужно ли ожидать обновления состояния. Значение по умолчанию — False. Default value: False
show_output	bool Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False. Default value: False

Возвращаемое значение

Тип	Описание
None	None

Исключения

Тип	Описание
ComputeTargetException

supported_vmsizes

Список поддерживаемых размеров виртуальных машин в регионе.

static supported_vmsizes(workspace, location=None)

Параметры

Имя	Описание
workspace Обязательно	Workspace Рабочая область.
location	str Расположение экземпляра. Если не указано, по умолчанию будет использоваться расположение рабочей области. Default value: None

Возвращаемое значение

Тип	Описание
list	Список поддерживаемых размеров виртуальных машин в регионе с именами виртуальных машин, виртуальных ЦП и оперативной памяти.

Исключения

Тип	Описание
ComputeTargetException

wait_for_completion

Время ожидания до завершения подготовки объекта ComputeInstance.

wait_for_completion(show_output=False, is_delete_operation=False)

Параметры

Имя	Описание
show_output	bool Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False. Default value: False
is_delete_operation	bool Указывает, предназначена ли операция для удаления. Default value: False

Исключения

Тип	Описание
ComputeTargetException