Image Classe
Define a classe pai abstrata para as Imagens do Azure Machine Learning.
Esta classe é DEPRECATED. Em vez disso, use a classe Environment.
Construtor de imagem.
Esta classe é DEPRECATED. Em vez disso, use a classe Environment.
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.
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 é "<nome>:<versão>") |
|
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 Modeldeploy() 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. |
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()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. |
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. A definição padrão é 'False'. Default value: False
|
Exceções
| Tipo | Description |
|---|---|