Partilhar via


Image Classe

Define a classe pai abstrata para as Imagens do Azure Machine Learning.

Esta classe é DEPRECATED. Em vez disso, use a Environment classe.

Construtor de imagem.

Esta classe é DEPRECATED. Em vez disso, use a Environment classe.

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

Herança
Image

Construtor

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

Parâmetros

Name Description
workspace
Necessário

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.

Default value: None
id
str

O ID específico da imagem a ser recuperada. (ID é "<nome>:<versão>")

Default value: None
tags

Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

Default value: None
properties

Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

Default value: None
version
str

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

Default value: None
workspace
Necessário

O objeto de espaço de trabalho que contém a imagem a ser recuperada

name
Necessário
str

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

id
Necessário
str

O ID específico da imagem a ser recuperada. (ID é ":")

tags
Necessário

Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

properties
Necessário

Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

version
Necessário
str

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

Observações

O construtor Image recupera uma representação na nuvem de um objeto Image associado ao espaço de trabalho 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 Webservicearquivo . O objeto Image normalmente contém um Model, um script de execução e quaisquer dependências necessárias para a implantação do Model. A classe Image tem várias subclasses, como ContainerImage for Docker Images, e Images, como FPGA.

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

As imagens são normalmente 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 Model deploy() 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 sua instalação local do Docker como uma imagem ou como um Dockerfile.

Consulte o link a seguir para obter uma visão geral sobre a implantação de modelos no Azure: https://aka.ms/azureml-how-deploy.

Métodos

add_properties

Adicione propriedades à imagem.

add_tags

Adicione tags à imagem.

create

Crie uma imagem no espaço de trabalho fornecido.

delete

Exclua uma imagem do espaço de trabalho 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 espaço de trabalho correspondente. Pode ser filtrado com parâmetros específicos.

remove_tags

Remova as tags da imagem.

serialize

Converta este 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. Principalmente útil 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á uma WebserviceException se ela atingir um estado de terminal sem êxito.

add_properties

Adicione propriedades à imagem.

add_properties(properties)

Parâmetros

Name Description
properties
Necessário

Um dicionário de propriedades a adicionar.

Exceções

Tipo Description

add_tags

Adicione tags à imagem.

add_tags(tags)

Parâmetros

Name Description
tags
Necessário

Um dicionário de tags para adicionar.

Exceções

Tipo Description

create

Crie uma imagem no espaço de trabalho fornecido.

static create(workspace, name, models, image_config)

Parâmetros

Name Description
workspace
Necessário
<xref:<xref:workspace: azureml.core.workspace.Workspace>>

O espaço de trabalho a ser associado a esta imagem.

name
Necessário
str

O nome a ser associado a esta imagem.

models
Necessário

Uma lista de objetos Model para empacotar com esta imagem. Pode ser uma lista vazia.

image_config
Necessário

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

Devoluções

Tipo Description

O objeto Image criado.

Exceções

Tipo Description

delete

Exclua uma imagem do espaço de trabalho correspondente.

delete()

Exceções

Tipo Description

Observações

Esse método falhará se a imagem tiver sido implantada em um serviço Web ao vivo.

deserialize

Converter um objeto json em um objeto Image.

deserialize(workspace, image_payload)

Parâmetros

Name Description
cls
Necessário

Indica o método de classe.

workspace
Necessário

O objeto de espaço de trabalho no qual a imagem está registrada.

image_payload
Necessário

Um objeto JSON para converter em um objeto Image.

Devoluções

Tipo Description

A representação Image do objeto JSON fornecido.

Exceções

Tipo Description

Observações

Esse método falhará se o espaço de trabalho fornecido não for o espaço de trabalho no qual a imagem está registrada.

image_configuration

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

abstract static image_configuration()

Exceções

Tipo Description

list

Liste as Imagens associadas ao espaço de trabalho 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

Name Description
workspace
Necessário

O objeto Workspace para listar as imagens em.

image_name
str

Lista de filtros para incluir apenas Imagens implantadas com o nome da imagem específica.

Default value: None
model_name
str

Lista de filtros para incluir apenas Imagens implantadas com o nome do modelo específico.

Default value: None
model_id
str

Lista de filtros para incluir apenas Imagens implantadas com o ID de modelo específico.

Default value: None
tags

Filtrará com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

Default value: None
properties

Filtrará com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex. ['chave', ['chave2', 'valor da chave2']]

Default value: None

Devoluções

Tipo Description
list[<xref:Images>]

Uma lista filtrada de Imagens no espaço de trabalho fornecido.

Exceções

Tipo Description

remove_tags

Remova as tags da imagem.

remove_tags(tags)

Parâmetros

Name Description
tags
Necessário

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

Exceções

Tipo Description

serialize

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

serialize()

Devoluções

Tipo Description

A representação JSON deste objeto Image.

Exceções

Tipo Description

update

Atualize a imagem.

update(tags)

Parâmetros

Name Description
tags
Necessário

Um dicionário de tags para atualizar a imagem. Substituirá todas as tags existentes.

Exceções

Tipo Description

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. Principalmente útil para sondagem manual do estado de criação.

update_creation_state()

Exceções

Tipo Description

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á uma WebserviceException se ela atingir um estado de terminal sem êxito.

wait_for_creation(show_output=False)

Parâmetros

Name Description
show_output

Opção booleana para imprimir uma saída mais detalhada. O padrão é False.

Default value: False

Exceções

Tipo Description