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 Image é usado para recuperar uma representação de 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
| Nome | Description |
|---|---|
|
workspace
Obrigatório
|
O objeto de workspace que contém o objeto Image a ser recuperado. |
|
name
|
O nome da imagem a ser recuperada. Retornará a versão mais recente da imagem, se existir. Valor padrão: None
|
|
id
|
A ID especificada da imagem a ser recuperada. (A ID é "<nome>:<versão>") Valor padrão: None
|
|
tags
|
Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] Valor padrão: None
|
|
properties
|
Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] Valor padrão: None
|
|
version
|
Quando a versão e o nome forem especificados, retornará a versão específica da imagem. Valor padrão: None
|
|
workspace
Obrigatório
|
O objeto de espaço de trabalho que contém a imagem a ser recuperada |
|
name
Obrigatório
|
O nome da imagem a ser recuperada. Retornará a versão mais recente, se existir |
|
id
Obrigatório
|
A ID especificada da imagem a ser recuperada. (ID é ":") |
|
tags
Obrigatório
|
Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] |
|
properties
Obrigatório
|
Filtrará os resultados da imagem com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] |
|
version
Obrigatório
|
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 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.
Normalmente, as imagens são usadas em fluxos de trabalho que exigem o uso de uma imagem. Para a maioria dos fluxos de trabalho, use a classe Environment para definir a 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 package() de Model para criar uma imagem que pode ser baixada para instalação local do Docker como uma imagem ou como um Dockerfile.
Confira o seguinte link para ter uma visão geral da 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 |
Listar as imagens associadas ao workspace correspondente. Pode ser filtrado com parâmetros específicos. |
| remove_tags |
Remover marcas da imagem. |
| serialize |
Converter esse objeto Image em um dicionário serializado JSON. |
| update |
Atualizar 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 |
Aguardar até a criação da imagem ser concluída. Aguardar a criação da imagem atingir um estado terminal. Gerará uma WebserviceException se atingir um estado terminal sem êxito. |
add_properties
Adicionar propriedades à imagem.
add_properties(properties)Parâmetros
| Nome | Description |
|---|---|
|
properties
Obrigatório
|
Um dicionário de propriedades a serem adicionadas. |
Exceções
| Tipo | Description |
|---|---|
add_tags
Adicionar marcas à imagem.
add_tags(tags)Parâmetros
| Nome | Description |
|---|---|
|
tags
Obrigatório
|
O dicionário de marcas a serem adicionadas. |
Exceções
| Tipo | Description |
|---|---|
create
Criar 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 esta imagem. |
|
name
Obrigatório
|
O nome a ser associado a esta imagem. |
|
models
Obrigatório
|
Uma lista de objetos Model a serem empacotados com esta imagem. Pode ser uma lista vazia. |
|
image_config
Obrigatório
|
O objeto de configuração de imagem a ser usado para configurar esta imagem. |
Retornos
| Tipo | Description |
|---|---|
|
O objeto Image criado. |
Exceções
| Tipo | Description |
|---|---|
delete
Excluir uma imagem do workspace correspondente.
delete()Exceções
| Tipo | Description |
|---|---|
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
| Nome | Description |
|---|---|
|
cls
Obrigatório
|
Indica o método de classe. |
|
workspace
Obrigatório
|
O objeto de workspace no qual a imagem está registrada. |
|
image_payload
Obrigatório
|
Um objeto JSON a ser convertido em um objeto Image. |
Retornos
| Tipo | Description |
|---|---|
|
A representação de imagem do objeto JSON fornecido. |
Exceções
| Tipo | Description |
|---|---|
Comentários
Esse método falhará se o 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
| Tipo | Description |
|---|---|
list
Listar 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
|
O objeto Workspace no qual listar as imagens. |
|
image_name
|
Filtrar a lista para incluir apenas imagens implantadas com o nome de imagem específico. Valor padrão: None
|
|
model_name
|
Filtrar a lista para incluir apenas imagens implantadas com o nome de modelo específico. Valor padrão: None
|
|
model_id
|
Filtrar a lista para incluir apenas imagens implantadas com a ID de modelo específica. Valor padrão: None
|
|
tags
|
Filtrará com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] Valor padrão: None
|
|
properties
|
Filtrará com base na lista fornecida, por 'chave' ou '[chave, valor]'. Ex.: ['chave', ['chave2', 'chave2 valor']] Valor padrão: None
|
Retornos
| Tipo | Description |
|---|---|
|
list[<xref:Images>]
|
Uma lista filtrada de imagens no workspace fornecido. |
Exceções
| Tipo | Description |
|---|---|
remove_tags
Remover marcas da imagem.
remove_tags(tags)Parâmetros
| Nome | Description |
|---|---|
|
tags
Obrigatório
|
Uma lista de chaves correspondentes às marcas a serem removidas. |
Exceções
| Tipo | Description |
|---|---|
serialize
Converter esse objeto Image em um dicionário serializado JSON.
serialize()Retornos
| Tipo | Description |
|---|---|
|
A representação JSON desse objeto Image. |
Exceções
| Tipo | Description |
|---|---|
update
Atualizar a imagem.
update(tags)Parâmetros
| Nome | Description |
|---|---|
|
tags
Obrigatório
|
Um dicionário de marcas com as quais atualizar a imagem. Substituirá as marcas existentes. |
Exceções
| Tipo | Description |
|---|---|
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
| Tipo | Description |
|---|---|
wait_for_creation
Aguardar até a criação da imagem ser concluída.
Aguardar a criação da imagem atingir um estado terminal. Gerará uma WebserviceException se atingir um estado terminal sem êxito.
wait_for_creation(show_output=False)Parâmetros
| Nome | Description |
|---|---|
|
show_output
|
Opção booliana para imprimir uma saída mais detalhada. Usa False como padrão. Valor padrão: False
|
Exceções
| Tipo | Description |
|---|---|