Image Classe

  • Referência

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
ABC
Image

Construtor

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

Parâmetros

Name Description
workspace
Necessá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.

Default value: None
id
str

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

Default value: None
tags
list

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
list

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
Workspace

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
list

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

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
dict[str, str]

Um dicionário de propriedades a adicionar.

Exceções

Tipo Description
WebserviceException

add_tags

Adicione tags à imagem.

add_tags(tags)

Parâmetros

Name Description
tags
Necessário
dict[str, str]

Um dicionário de tags para adicionar.

Exceções

Tipo Description
WebserviceException

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
list[Model]

Uma lista de objetos Model para empacotar com esta imagem. Pode ser uma lista vazia.
image_config
Necessário
ImageConfig

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

Devoluções

Tipo Description
Image

O objeto Image criado.

Exceções

Tipo Description
WebserviceException

delete

Exclua uma imagem do espaço de trabalho correspondente.

delete()

Exceções

Tipo Description
WebserviceException

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
Workspace

O objeto de espaço de trabalho no qual a imagem está registrada.
image_payload
Necessário
dict

Um objeto JSON para converter em um objeto Image.

Devoluções

Tipo Description
Image

A representação Image do objeto JSON fornecido.

Exceções

Tipo Description
WebserviceException

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
WebserviceException

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
Workspace

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
list

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

Default value: None
properties
list

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
WebserviceException

remove_tags

Remova as tags da imagem.

remove_tags(tags)

Parâmetros

Name Description
tags
Necessário
list[str]

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

Exceções

Tipo Description
WebserviceException

serialize

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

serialize()

Devoluções

Tipo Description
dict

A representação JSON deste objeto Image.

Exceções

Tipo Description
WebserviceException

update

Atualize a imagem.

update(tags)

Parâmetros

Name Description
tags
Necessário
dict[str, str]

Um dicionário de tags para atualizar a imagem. Substituirá todas as tags 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. Principalmente útil 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á uma WebserviceException se ela atingir um estado de terminal sem êxito.

wait_for_creation(show_output=False)

Parâmetros

Name Description
show_output
bool

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

Default value: False

Exceções

Tipo Description
WebserviceException