Image Класс
Определяет абстрактный родительский класс для образов Машинного обучения Azure.
Использовать этот класс НЕ РЕКОМЕНДУЕТСЯ. Используйте вместо этого класс Environment.
Конструктор изображений.
Использовать этот класс НЕ РЕКОМЕНДУЕТСЯ. Используйте вместо этого класс Environment.
Конструктор изображений используется для получения облачного представления объекта Image, связанного с предоставленной рабочей областью. Возвращает экземпляр дочернего класса, соответствующий конкретному типу полученного объекта Image.
- Наследование
-
Image
Конструктор
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)Параметры
- name
- str
Имя получаемого образа. Будет возвращать последнюю версию образа, если она существует.
- id
- str
Конкретный идентификатор извлекаемого образа. (Идентификатор — "< имя >:<версия>")
- tags
- list
Фильтрация результатов будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
- properties
- list
Фильтрация результатов будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
- version
- str
Если указаны и имя, и версия, будет возвращена конкретная версия образа.
- tags
- list
Фильтрация результатов будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
- properties
- list
Фильтрация результатов будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
Комментарии
Конструктор образа извлекает облачное представление объекта образа, связанного с указанной рабочей областью. Возвращает экземпляр дочернего класса, соответствующий конкретному типу полученного объекта образа.
Объект образа используется для развертывания 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)Параметры
Исключения
add_tags
Добавляет теги к образу.
add_tags(tags)Параметры
Исключения
create
Создает образ в указанной рабочей области.
static create(workspace, name, models, image_config)Параметры
- workspace
- <xref:<xref:workspace: azureml.core.workspace.Workspace>>
Рабочая область, связываемая с этим образом.
Список объектов модели для упаковки с этим образом. Может быть пустым списком.
- image_config
- ImageConfig
Объект конфигурации образа, используемый для настройки этого образа.
Возвращаемое значение
Созданный объект образа.
Возвращаемый тип
Исключения
delete
Удаляет образ из соответствующей рабочей области.
delete()Исключения
Комментарии
Этот метод завершается ошибкой, если образ был развернут в динамической веб-службе.
deserialize
Преобразует объект JSON в объект образа.
deserialize(workspace, image_payload)Параметры
- cls
Указывает метод класса.
Возвращаемое значение
Представление образа указанного объекта JSON.
Возвращаемый тип
Исключения
Комментарии
Этот метод завершается ошибкой, если указанная рабочая область не является рабочей областью, в которой зарегистрирован данный образ.
image_configuration
Абстрактный метод для создания объекта конфигурации образа.
abstract static image_configuration()Исключения
list
Выводит список образов, связанные с соответствующей рабочей областью. Можно фильтровать с использованием конкретных параметров.
static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)Параметры
- image_name
- str
Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени образа.
- model_name
- str
Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного имени модели.
- model_id
- str
Фильтрует список для включения только тех образов, которые были развернуты с использованием указанного идентификатора модели.
- tags
- list
Фильтрация будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
- properties
- list
Фильтрация будет осуществляться по указанному списку: "ключ" или "[ключ, значение]". Например: ["ключ", ["ключ2", "ключ2 значение"]]
Возвращаемое значение
Отфильтрованный список образов в указанной рабочей области.
Возвращаемый тип
Исключения
remove_tags
Удаляет тегов из образа.
remove_tags(tags)Параметры
Исключения
serialize
Преобразовывает данный объект образа в сериализованный словарь JSON.
serialize()Возвращаемое значение
Представление JSON данного объекта образа.
Возвращаемый тип
Исключения
update
Обновляет образа.
update(tags)Параметры
Словарь тегов, используемых для обновления образа. Выполняет перезапись всех существующих тегов.
Исключения
update_creation_state
Обновление текущего состояния объекта в памяти.
Обновление свойств объекта на месте на основе текущего состояния соответствующего облачного объекта. Это полезно в первую очередь при опросе состояния создания вручную.
update_creation_state()Исключения
wait_for_creation
Дождитесь завершения создания образа.
Дождитесь, пока создание образа достигнет терминального состояния. При достижении неуспешного терминального состояния вызовет исключение WebserviceException.
wait_for_creation(show_output=False)Параметры
- show_output
- bool
Логический параметр для печати более подробных выходных данных. Значение по умолчанию — False.
Исключения
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по