Поделиться через


ComputeInstance Класс

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

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

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

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

Наследование
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
значение по умолчанию: False
show_output
значение по умолчанию: False

Исключения

Комментарии

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

deserialize

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

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

static deserialize(workspace, object_dict)

Параметры

workspace
Workspace
Обязательно

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

object_dict
dict
Обязательно

Объект JSON, преобразуемый в объект ComputeInstance.

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

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

Возвращаемый тип

Исключения

detach

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

detach()

Исключения

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

get

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

get()

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

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

Возвращаемый тип

Исключения

get_active_runs

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

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

Параметры

type
str
значение по умолчанию: None

Фильтрует возвращенный генератор запусков по предоставленному типу. См. раздел add_type_provider для создания типов запуска.

tags
str или dict
значение по умолчанию: None

Для запуска фильтрации используется "метка" или {"метка": "значение"}

properties
str или dict
значение по умолчанию: None

Для фильтрации используется "свойство" или {"свойство": "значение"}

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
Обязательно

Размер виртуальных машин агента. Дополнительные сведения приведены в 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

Имя подсети в виртуальной сети.

tags
dict[str, str]
значение по умолчанию: None

Необязательный словарь тегов значений ключа, связываемый с объектом вычисления.

description
str
значение по умолчанию: None

Необязательное описание объекта вычисления.

assigned_user_object_id
str
значение по умолчанию: None

Идентификатор объекта Azure Active Directory назначенного пользователя (предварительная версия).

assigned_user_tenant_id
str
значение по умолчанию: None

Идентификатор клиента Azure Active Directory назначенного пользователя (предварительная версия).

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

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

Возвращаемый тип

Исключения

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.

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

None

Возвращаемый тип

Исключения

azureml.exceptions.ComputeTargetException:

serialize

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

serialize()

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

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

Возвращаемый тип

Исключения

start

Запуск ComputeInstance.

start(wait_for_completion=False, show_output=False)

Параметры

wait_for_completion
bool
значение по умолчанию: False

Нужно ли ожидать обновления состояния. Значение по умолчанию — False.

show_output
bool
значение по умолчанию: False

Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False.

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

None

Возвращаемый тип

Исключения

stop

Остановка ComputeInstance.

stop(wait_for_completion=False, show_output=False)

Параметры

wait_for_completion
bool
значение по умолчанию: False

Нужно ли ожидать обновления состояния. Значение по умолчанию — False.

show_output
bool
значение по умолчанию: False

Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False.

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

None

Возвращаемый тип

Исключения

supported_vmsizes

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

static supported_vmsizes(workspace, location=None)

Параметры

workspace
Workspace
Обязательно

Рабочая область.

location
str
значение по умолчанию: None

Расположение экземпляра. Если не указано, по умолчанию будет использоваться расположение рабочей области.

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

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

Возвращаемый тип

Исключения

wait_for_completion

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

wait_for_completion(show_output=False, is_delete_operation=False)

Параметры

show_output
bool
значение по умолчанию: False

Нужно ли предоставлять более подробные выходные данные. Значение по умолчанию — False.

is_delete_operation
bool
значение по умолчанию: False

Указывает, предназначена ли операция для удаления.

Исключения