Image Class

Defines the abstract parent class for Azure Machine Learning Images.

This class is DEPRECATED. Use the Environment class instead.

Image constructor.

This class is DEPRECATED. Use the Environment class instead.

Image constructor is used to retrieve a cloud representation of a Image object associated with the provided workspace. Will return an instance of a child class corresponding to the specific type of the retrieved Image object.

Inheritance
Image

Constructor

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

Parameters

workspace
Workspace
Required

The Workspace object containing the Image to retrieve.

name
str
default value: None

The name of the Image to retrieve. Will return the latest version of the Image, if it exists.

id
str
default value: None

The specific ID of the Image to retrieve. (ID is "<name>:<version>")

tags
list
default value: None

Will filter Image results based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
default value: None

Will filter Image results based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

version
str
default value: None

When version and name are both specified, will return the specific version of the Image.

workspace
Workspace
Required

The workspace object containing the Image to retrieve

name
str
Required

The name of the Image to retrieve. Will return the latest version, if it exists

id
str
Required

The specific ID of the Image to retrieve. (ID is ":")

tags
list
Required

Will filter Image results based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
Required

Will filter Image results based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

version
str
Required

When version and name are both specified, will return the specific version of the Image.

Remarks

The Image constructor retrieves a cloud representation of an Image object associated with the provided workspace. It returns an instance of a child class corresponding to the specific type of the retrieved Image object.

An Image object is used to deploy a user's Model as a Webservice. The Image object typically contains a Model, an execution script, and any dependencies needed for Model deployment. The Image class has multiple subclasses such as ContainerImage for Docker Images, and Images like FPGA.

See the ContainerImage class for an example of a class that inherits from the Image class.

Images are typically used in workflows that require using an image. For most workflows, you should instead use the Environment class to define your image. Then you can use the Environment object with the Model deploy() method to deploy the model as a web service. You can also use the Model package() method to create an image that can be downloaded to your local Docker install as an image or as a Dockerfile.

See the following link for an overview on deploying models in Azure: https://aka.ms/azureml-how-deploy.

Methods

add_properties

Add properties to the image.

add_tags

Add tags to the image.

create

Create an image in the provided workspace.

delete

Delete an image from its corresponding workspace.

deserialize

Convert a json object into a Image object.

image_configuration

Abstract method for creating an image configuration object.

list

List the Images associated with the corresponding workspace. Can be filtered with specific parameters.

remove_tags

Remove tags from the image.

serialize

Convert this Image object into a JSON serialized dictionary.

update

Update the image.

update_creation_state

Refresh the current state of the in-memory object.

Perform an in-place update of the properties of the object based on the current state of the corresponding cloud object. Primarily useful for manual polling of creation state.

wait_for_creation

Wait for the image to finish creating.

Wait for image creation to reach a terminal state. Will throw a WebserviceException if it reaches a non-successful terminal state.

add_properties

Add properties to the image.

add_properties(properties)

Parameters

properties
dict[str, str]
Required

A dictionary of properties to add.

Exceptions

add_tags

Add tags to the image.

add_tags(tags)

Parameters

tags
dict[str, str]
Required

A dictionary of tags to add.

Exceptions

create

Create an image in the provided workspace.

static create(workspace, name, models, image_config)

Parameters

workspace
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
Required

The workspace to associate with this image.

name
str
Required

The name to associate with this image.

models
list[Model]
Required

A list of Model objects to package with this image. Can be an empty list.

image_config
ImageConfig
Required

The image config object to use to configure this image.

Returns

The created Image object.

Return type

Exceptions

delete

Delete an image from its corresponding workspace.

delete()

Exceptions

Remarks

This method fails if the image has been deployed to a live webservice.

deserialize

Convert a json object into a Image object.

deserialize(workspace, image_payload)

Parameters

cls
Required

Indicates class method.

workspace
Workspace
Required

The workspace object the Image is registered under.

image_payload
dict
Required

A JSON object to convert to a Image object.

Returns

The Image representation of the provided JSON object.

Return type

Exceptions

Remarks

This method fails if the provided workspace is not the workspace the image is registered under.

image_configuration

Abstract method for creating an image configuration object.

abstract static image_configuration()

Exceptions

list

List the Images associated with the corresponding workspace. Can be filtered with specific parameters.

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

Parameters

workspace
Workspace
Required

The Workspace object to list the Images in.

image_name
str
default value: None

Filter list to only include Images deployed with the specific image name.

model_name
str
default value: None

Filter list to only include Images deployed with the specific model name.

model_id
str
default value: None

Filter list to only include Images deployed with the specific model ID.

tags
list
default value: None

Will filter based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

properties
list
default value: None

Will filter based on the provided list, by either 'key' or '[key, value]'. Ex. ['key', ['key2', 'key2 value']]

Returns

A filtered list of Images in the provided workspace.

Return type

list[<xref:Images>]

Exceptions

remove_tags

Remove tags from the image.

remove_tags(tags)

Parameters

tags
list[str]
Required

A list of keys corresponding to tags to be removed.

Exceptions

serialize

Convert this Image object into a JSON serialized dictionary.

serialize()

Returns

The JSON representation of this Image object.

Return type

Exceptions

update

Update the image.

update(tags)

Parameters

tags
dict[str, str]
Required

A dictionary of tags to update the image with. Will overwrite any existing tags.

Exceptions

update_creation_state

Refresh the current state of the in-memory object.

Perform an in-place update of the properties of the object based on the current state of the corresponding cloud object. Primarily useful for manual polling of creation state.

update_creation_state()

Exceptions

wait_for_creation

Wait for the image to finish creating.

Wait for image creation to reach a terminal state. Will throw a WebserviceException if it reaches a non-successful terminal state.

wait_for_creation(show_output=False)

Parameters

show_output
bool
default value: False

Boolean option to print more verbose output. Defaults to False.

Exceptions