Image Classe

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

Essa classe foi PRETERIDA. Use a classe Environment em seu lugar.

Construtor de imagem.

Essa classe foi PRETERIDA. Use a classe Environment em seu lugar.

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.

Herança
Image

Construtor

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

Parâmetros

workspace
Workspace
Obrigatório

O objeto de workspace que contém o objeto Image a ser recuperado.

name
str
valor padrão: None

O nome do objeto Image a ser recuperado. Retornará a versão mais recente do objeto Image, se ela existir.

id
str
valor padrão: None

A ID especificada da imagem a ser recuperada. (ID é "<nome>:<versão>")

tags
list
valor padrão: None

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

properties
list
valor padrão: None

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

version
str
valor padrão: None

Quando a versão e o nome forem especificados, retornará a versão específica do objeto Image.

workspace
Workspace
Obrigatório

O objeto de workspace que contém a Imagem a ser recuperada

name
str
Obrigatório

O nome do objeto Image a ser recuperado. Retornará a versão mais recente, se ela existir

id
str
Obrigatório

A ID especificada da imagem a ser recuperada. (A ID é ":")

tags
list
Obrigatório

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

properties
list
Obrigatório

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

version
str
Obrigatório

Quando a versão e o nome forem especificados, retornará a versão específica do objeto Image.

Comentários

O construtor Image recupera uma representação em 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 o Model de um usuário como um Webservice. O objeto Image normalmente contém um modelo, um script de execução e todas as 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.

Confira a classe ContainerImage 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 em vez disso usar a classe Environment para definir a imagem. Em seguida, você pode usar o objeto de ambiente com o método Modeldeploy() para implantar o modelo como um serviço Web. Você também pode usar o método Modelo 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 seguinte link para obter uma visão geral sobre a implantação de modelos no Azure: https://aka.ms/azureml-how-deploy.

Métodos

add_properties

Adicionar propriedades à imagem.

add_tags

Adicionar marcas à imagem.

create

Criar uma imagem no workspace fornecido.

delete

Excluir uma imagem do 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

Remove as marcas da imagem.

serialize

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

update

Atualiza a imagem.

update_creation_state

Atualizar o estado atual do objeto na memória.

Executar uma atualização local 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é a criação da imagem ser concluída.

Aguarde a criação da imagem atingir um estado terminal. Gerará uma WebserviceException se atingir um estado terminal não bem-sucedido.

add_properties

Adicionar propriedades à imagem.

add_properties(properties)

Parâmetros

properties
dict[str, str]
Obrigatório

Um dicionário de propriedades a serem adicionadas.

Exceções

add_tags

Adicionar marcas à imagem.

add_tags(tags)

Parâmetros

tags
dict[str, str]
Obrigatório

O dicionário de marcas a serem adicionadas.

Exceções

create

Criar uma imagem no workspace fornecido.

static create(workspace, name, models, image_config)

Parâmetros

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

O workspace a ser associado a esta imagem.

name
str
Obrigatório

O nome a ser associado a esta imagem.

models
list[Model]
Obrigatório

Uma lista de objetos de modelo a serem empacotados com esta imagem. Pode ser uma lista vazia.

image_config
ImageConfig
Obrigatório

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

Retornos

O objeto Image criado.

Tipo de retorno

Exceções

delete

Excluir uma imagem do workspace correspondente.

delete()

Exceções

Comentários

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

cls
Obrigatório

Indica o método de classe.

workspace
Workspace
Obrigatório

O objeto de workspace no qual a imagem está registrada.

image_payload
dict
Obrigatório

Um objeto JSON a ser convertido em um objeto Image.

Retornos

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

Tipo de retorno

Exceções

Comentários

Esse método falhará se workspace fornecido não for aquele em que a imagem está registrada.

image_configuration

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

abstract static image_configuration()

Exceções

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

workspace
Workspace
Obrigatório

O objeto de workspace no qual listar as imagens.

image_name
str
valor padrão: None

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

model_name
str
valor padrão: None

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

model_id
str
valor padrão: None

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

tags
list
valor padrão: None

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

properties
list
valor padrão: None

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

Retornos

Uma lista filtrada de imagens no workspace fornecido.

Tipo de retorno

list[<xref:Images>]

Exceções

remove_tags

Remove as marcas da imagem.

remove_tags(tags)

Parâmetros

tags
list[str]
Obrigatório

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

Exceções

serialize

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

serialize()

Retornos

A representação JSON desse objeto Image.

Tipo de retorno

Exceções

update

Atualiza a imagem.

update(tags)

Parâmetros

tags
dict[str, str]
Obrigatório

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

Exceções

update_creation_state

Atualizar o estado atual do objeto na memória.

Executar uma atualização local 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

wait_for_creation

Aguarde até a criação da imagem ser concluída.

Aguarde a criação da imagem atingir um estado terminal. Gerará uma WebserviceException se atingir um estado terminal não bem-sucedido.

wait_for_creation(show_output=False)

Parâmetros

show_output
bool
valor padrão: False

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

Exceções