Image Класс

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

Использовать этот класс НЕ РЕКОМЕНДУЕТСЯ. Используйте вместо этого класс Environment.

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

Использовать этот класс НЕ РЕКОМЕНДУЕТСЯ. Используйте вместо этого класс Environment.

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

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

ABC

Image

Конструктор

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

Параметры

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

Комментарии

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

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

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

Образы обычно используются в рабочих процессах, требующих использования образа. Для большинства рабочих процессов вместо этого следует использовать класс Environment для определения образа. Затем можно использовать объект среды с использованием метода Modeldeploy() для развертывания модели в качестве веб-службы. Можно также использовать метод 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 Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени образа. значение по умолчанию: None
model_name	str Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени модели. значение по умолчанию: None
model_id	str Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного идентификатора модели. значение по умолчанию: None
tags	list Фильтрация будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] значение по умолчанию: None
properties	list Фильтрация будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]] значение по умолчанию: 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. значение по умолчанию: False

Исключения

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