Image Класс

Ссылка

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

Не рекомендуется использовать этот класс. Используйте вместо этого класс Environment.

Конструктор изображений.

Не рекомендуется использовать этот класс. Используйте вместо этого класс Environment.

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

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

Image

Конструктор

Image(workspace, name=None, id=None, tags=None, properties=None, version=None)

Параметры

Имя	Описание
workspace Обязательно	Workspace Объект рабочей области, содержащий извлекаемый образ.
name	str Имя получаемого образа. Будет возвращать последнюю версию образа, если она существует. Default value: None
id	str Конкретный идентификатор извлекаемого образа. (Идентификатор — "<имя>:<версия>") Default value: None
tags	list Фильтрация результатов будет осуществляться по указанному списку — по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] Default value: None
properties	list Фильтрация результатов будет осуществляться по указанному списку — по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] Default value: None
version	str Если указаны и имя, и версия, будет возвращена конкретная версия образа. Default value: None
workspace Обязательно	Workspace Объект рабочей области, содержащий изображение для получения
name Обязательно	str Имя получаемого образа. Возвращает последнюю версию, если она существует
id Обязательно	str Конкретный идентификатор извлекаемого образа. (Идентификатор : ":")
tags Обязательно	list Фильтрация результатов будет осуществляться по указанному списку — по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
properties Обязательно	list Фильтрация результатов будет осуществляться по указанному списку — по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
version Обязательно	str Если указаны и имя, и версия, будет возвращена конкретная версия образа.

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

Объект образа используется для развертывания Model пользователя в качестве Webservice. Объект образа обычно содержит модель, скрипт выполнения и все зависимости, необходимые для развертывания модели. Класс образа имеет несколько подклассов, например ContainerImage для образов Docker и образы для ППВМ.

См. класс ContainerImage в качестве примера класса, который наследуется от класса образа.

Образы обычно используются в рабочих процессах, требующих использования образа. Для большинства рабочих процессов вместо этого следует использовать класс Environment для определения образа. Затем можно использовать объект Environment с Model deploy() методом для развертывания модели в качестве веб-службы. Можно также использовать метод модели package() для создания образа, который можно скачать в локальную установку Docker в виде образа или файла Dockerfile.

Общие сведения о развертывании моделей в Azure см. на странице https://aka.ms/azureml-how-deploy.

Методы

add_properties	Добавляет свойства к образу.
add_tags	Добавляет теги к образу.
create	Создает образ в указанной рабочей области.
delete	Удаляет образ из соответствующей рабочей области.
deserialize	Преобразует объект JSON в объект образа.
image_configuration	Абстрактный метод для создания объекта конфигурации образа.
list	Выводит образы, связанные с соответствующей рабочей областью. Можно применять фильтрацию с помощью определенных параметров.
remove_tags	Удаляет теги из образа.
serialize	Преобразует этот объект образа в сериализованный словарь JSON.
update	Обновляет образ.
update_creation_state	Обновление текущего состояния объекта в памяти. Обновляет свойства объекта на месте с учетом текущего состояния соответствующего облачного объекта. Это полезно в первую очередь при опросе состояния создания вручную.
wait_for_creation	Ожидает завершения создания образа. Ожидает, пока процесс создания образа не завершит все операции. Если операции не будут завершены успешно, вызовет исключение WebserviceException.

add_properties

Добавляет свойства к образу.

add_properties(properties)

Параметры

Имя	Описание
properties Обязательно	dict[str, str] Словарь свойств для добавления.

Исключения

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

add_tags

Добавляет теги к образу.

add_tags(tags)

Параметры

Имя	Описание
tags Обязательно	dict[str, str] Словарь тегов для добавления.

Исключения

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

create

Создает образ в указанной рабочей области.

static create(workspace, name, models, image_config)

Параметры

Имя	Описание
workspace Обязательно	<xref:<xref:workspace: azureml.core.workspace.Workspace>> Рабочая область, связываемая с этим образом.
name Обязательно	str Имя, связываемое с этим образом.
models Обязательно	list[Model] Список объектов модели для упаковки с этим образом. Может быть пустым списком.
image_config Обязательно	ImageConfig Объект конфигурации образа, используемый для настройки этого образа.

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

Тип	Описание
Image	Созданный объект образа.

Исключения

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

delete

Удаляет образ из соответствующей рабочей области.

delete()

Исключения

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

deserialize

Преобразует объект JSON в объект образа.

deserialize(workspace, image_payload)

Параметры

Имя	Описание
cls Обязательно	Указывает метод класса.
workspace Обязательно	Workspace Объект рабочей области, в котором зарегистрирован образ.
image_payload Обязательно	dict Объект JSON для преобразования в объект образа.

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

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

Исключения

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

image_configuration

Абстрактный метод для создания объекта конфигурации образа.

abstract static image_configuration()

Исключения

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

list

Выводит образы, связанные с соответствующей рабочей областью. Можно применять фильтрацию с помощью определенных параметров.

static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

Параметры

Имя	Описание
workspace Обязательно	Workspace Объект рабочей области для вывода списка образов.
image_name	str Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени образа. Default value: None
model_name	str Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени модели. Default value: None
model_id	str Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного идентификатора модели. Default value: None
tags	list Фильтрация будет осуществляться по указанному списку: по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] Default value: None
properties	list Фильтрация будет осуществляться по указанному списку: по "ключу" или паре "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] Default value: None

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

Тип	Описание
list[<xref:Images>]	Отфильтрованный список образов в указанной рабочей области.

Исключения

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

remove_tags

Удаляет теги из образа.

remove_tags(tags)

Параметры

Имя	Описание
tags Обязательно	list[str] Список ключей, соответствующих удаляемым тегам.

Исключения

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

serialize

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

serialize()

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

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

Исключения

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

update

Обновляет образ.

update(tags)

Параметры

Имя	Описание
tags Обязательно	dict[str, str] Словарь тегов, используемых для обновления образа. Выполняет перезапись всех существующих тегов.

Исключения

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

update_creation_state

Обновление текущего состояния объекта в памяти.

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

update_creation_state()

Исключения

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

wait_for_creation

Ожидает завершения создания образа.

Ожидает, пока процесс создания образа не завершит все операции. Если операции не будут завершены успешно, вызовет исключение WebserviceException.

wait_for_creation(show_output=False)

Параметры

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

Исключения

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

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

Image Класс

Конструктор

Параметры

Комментарии

Методы

add_properties

Параметры

Исключения

add_tags

Параметры

Исключения

create

Параметры

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

Исключения

delete

Исключения

Комментарии

deserialize

Параметры

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

Исключения

Комментарии

image_configuration

Исключения

list

Параметры

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

Исключения

remove_tags

Параметры

Исключения

serialize

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

Исключения

update

Параметры

Исключения

update_creation_state

Исключения

wait_for_creation

Параметры

Исключения

Обратная связь

Дополнительные ресурсы