Compartilhar via

Image Classe

Define a classe pai abstrata para imagens do Azure Machine Learning.

Essa classe é PRETERIDA. Em vez disso, use a classe Environment.

Construtor de imagem.

Essa classe é PRETERIDA. Em vez disso, use a classe Environment.

O construtor de imagem é usado para recuperar uma representação na nuvem de um objeto Image associado ao workspace fornecido. Retornará uma instância de uma classe filho correspondente ao tipo específico do objeto Image recuperado.

Construtor

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

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto Workspace que contém a imagem a ser recuperada.
name
str

O nome da imagem a ser recuperada. Retornará a versão mais recente da Imagem, se ela existir.

Valor padrão: None
id
str

A ID específica da imagem a ser recuperada. (A ID é "<name>:<version>")

Valor padrão: None
tags
list

Filtrará os resultados da imagem com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]

Valor padrão: None
properties
list

Filtrará os resultados da imagem com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]

Valor padrão: None
version
str

Quando a versão e o nome forem especificados, retornará a versão específica da Imagem.

Valor padrão: None
workspace
Obrigatório
Workspace

O objeto de workspace que contém a imagem a ser recuperada
name
Obrigatório
str

O nome da imagem a ser recuperada. Retornará a versão mais recente, se ela existir
id
Obrigatório
str

A ID específica da imagem a ser recuperada. (A ID é "<name>:<version>")
tags
Obrigatório
list

Filtrará os resultados da imagem com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]
properties
Obrigatório
list

Filtrará os resultados da imagem com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]
version
Obrigatório
str

Quando a versão e o nome forem especificados, retornará a versão específica da Imagem.

Comentários

O construtor image recupera uma representação na nuvem de um objeto Image associado ao workspace fornecido. Ele retorna uma instância de uma classe filho correspondente ao tipo específico do objeto Image recuperado.

Um objeto Image é usado para implantar um usuário Model como um Webservice. O objeto Image normalmente contém um Modelo, um script de execução e quaisquer dependências necessárias para a implantação do Modelo. A classe Image tem várias subclasses, como ContainerImage para Imagens do Docker e Imagens como FPGA.

Consulte a ContainerImage classe para obter um exemplo de uma classe que herda da classe Image.

Normalmente, as imagens são usadas em fluxos de trabalho que exigem o uso de uma imagem. Para a maioria dos fluxos de trabalho, você deve usar a Environment classe para definir sua imagem. Em seguida, você pode usar o objeto Environment com o Modeldeploy() método para implantar o modelo como um serviço Web. Você também pode usar o método Model package() para criar uma imagem que pode ser baixada para a instalação local do Docker como uma imagem ou como um Dockerfile.

Confira o link a seguir para obter uma visão geral sobre como implantar modelos no Azure: https://aka.ms/azureml-how-deploy.

Métodos

add_properties

Adicione propriedades à imagem.
add_tags

Adicione marcas à imagem.
create

Crie uma imagem no workspace fornecido.
delete

Exclua uma imagem de seu workspace correspondente.
deserialize

Converter um objeto json em um objeto Image.
image_configuration

Método abstrato para criar um objeto de configuração de imagem.
list

Liste as imagens associadas ao workspace correspondente. Pode ser filtrado com parâmetros específicos.
remove_tags

Remova marcas da imagem.
serialize

Converta esse objeto Image em um dicionário serializado JSON.
update

Atualize a imagem.
update_creation_state

Atualize o estado atual do objeto na memória.

Execute uma atualização in-loco das propriedades do objeto com base no estado atual do objeto de nuvem correspondente. Útil principalmente para sondagem manual do estado de criação.
wait_for_creation

Aguarde até que a imagem termine de criar.

Aguarde até que a criação da imagem atinja um estado terminal. Lançará um WebserviceException se atingir um estado terminal não bem-sucedido.

add_properties

Adicione propriedades à imagem.

add_properties(properties)

Parâmetros

Nome Description
properties
Obrigatório
dict[str, str]

Um dicionário de propriedades a serem adicionadas.

Exceções

Tipo Description
WebserviceException

add_tags

Adicione marcas à imagem.

add_tags(tags)

Parâmetros

Nome Description
tags
Obrigatório
dict[str, str]

Um dicionário de marcas a serem adicionadas.

Exceções

Tipo Description
WebserviceException

create

Crie uma imagem no workspace fornecido.

static create(workspace, name, models, image_config)

Parâmetros

Nome Description
workspace
Obrigatório
<xref:<xref:workspace: azureml.core.workspace.Workspace>>

O workspace a ser associado a essa imagem.
name
Obrigatório
str

O nome a ser associado a essa imagem.
models
Obrigatório
list[Model]

Uma lista de objetos Model a serem empacotados com essa imagem. Pode ser uma lista vazia.
image_config
Obrigatório
ImageConfig

O objeto de configuração de imagem a ser usado para configurar essa imagem.

Retornos

Tipo Description
Image

O objeto Image criado.

Exceções

Tipo Description
WebserviceException

delete

Exclua uma imagem de seu workspace correspondente.

delete()

Exceções

Tipo Description
WebserviceException

Comentários

Esse método falhará se a imagem tiver sido implantada em um serviço Web dinâmico.

deserialize

Converter um objeto json em um objeto Image.

deserialize(workspace, image_payload)

Parâmetros

Nome Description
cls
Obrigatório

Indica o método de classe.
workspace
Obrigatório
Workspace

O objeto de workspace no qual a Imagem está registrada.
image_payload
Obrigatório
dict

Um objeto JSON a ser convertido em um objeto Image.

Retornos

Tipo Description
Image

A representação de imagem do objeto JSON fornecido.

Comentários

Esse método falhará se o workspace fornecido não for o workspace no qual a imagem está registrada.

image_configuration

Método abstrato para criar um objeto de configuração de imagem.

abstract static image_configuration()

list

Liste as imagens associadas ao workspace correspondente. Pode ser filtrado com parâmetros específicos.

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

Parâmetros

Nome Description
workspace
Obrigatório
Workspace

O objeto Workspace no qual listar as imagens.
image_name
str

Filtrar lista para incluir apenas imagens implantadas com o nome de imagem específico.

Valor padrão: None
model_name
str

Filtrar lista para incluir apenas imagens implantadas com o nome do modelo específico.

Valor padrão: None
model_id
str

Filtrar lista para incluir apenas imagens implantadas com a ID de modelo específica.

Valor padrão: None
tags
list

Filtrará com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]

Valor padrão: None
properties
list

Filtrará com base na lista fornecida, por 'key' ou '[key, value]'. Ex.: ['key', ['key2', 'key2 value']]

Valor padrão: None

Retornos

Tipo Description
list[<xref:Images>]

Uma lista filtrada de imagens no workspace fornecido.

Exceções

Tipo Description
WebserviceException

remove_tags

Remova marcas da imagem.

remove_tags(tags)

Parâmetros

Nome Description
tags
Obrigatório
list[str]

Uma lista de chaves correspondentes às marcas a serem removidas.

Exceções

Tipo Description
WebserviceException

serialize

Converta esse objeto Image em um dicionário serializado JSON.

serialize()

Retornos

Tipo Description
dict

A representação JSON deste objeto Image.

update

Atualize a imagem.

update(tags)

Parâmetros

Nome Description
tags
Obrigatório
dict[str, str]

Um dicionário de marcas com o qual atualizar a imagem. Substituirá as marcas existentes.

Exceções

Tipo Description
WebserviceException

update_creation_state

Atualize o estado atual do objeto na memória.

Execute uma atualização in-loco das propriedades do objeto com base no estado atual do objeto de nuvem correspondente. Útil principalmente para sondagem manual do estado de criação.

update_creation_state()

Exceções

Tipo Description
WebserviceException

wait_for_creation

Aguarde até que a imagem termine de criar.

Aguarde até que a criação da imagem atinja um estado terminal. Lançará um WebserviceException se atingir um estado terminal não bem-sucedido.

wait_for_creation(show_output=False)

Parâmetros

Nome Description
show_output
bool

Opção booliana para imprimir uma saída mais detalhada. Usa False como padrão.

Valor padrão: False

Exceções

Tipo Description
WebserviceException