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
|
O nome da imagem a ser recuperada. Retornará a versão mais recente da imagem, se ela existir. Default value: None
|
id
|
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
|
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
|
O nome da imagem a ser recuperada. Retornará a versão mais recente, se ela existir |
id
Necessário
|
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
|
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
|
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
|
Lista de filtros para incluir apenas Imagens implantadas com o nome da imagem específica. Default value: None
|
model_name
|
Lista de filtros para incluir apenas Imagens implantadas com o nome do modelo específico. Default value: None
|
model_id
|
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 |
---|---|