Image Classe

Define a classe pai abstrata para Azure Machine Learning imagens.

Essa classe foi preterida. Use a classe Ambiente em seu lugar.

Herança
abc.ABC
Image

Construtor

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

Parâmetros

workspace
Workspace

O objeto de espaço de trabalho que contém a imagem a ser recuperada.

name
<xref:str>

O nome da imagem a ser recuperada. Retornará a versão mais recente da imagem, se ela existir.

id
<xref:str>

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

tags
list

Filtrará os resultados da imagem com base na lista fornecida, por ' chave ' ou ' [chave, valor] '. Exemplo: [' Key ', [' Key2 ', ' Key2 value ']]

properties
list

Filtrará os resultados da imagem com base na lista fornecida, por ' chave ' ou ' [chave, valor] '. Exemplo: [' Key ', [' Key2 ', ' Key2 value ']]

version
<xref:str>

Quando a versão e o nome forem especificados, o 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 espaço de trabalho fornecido. Ele retorna uma instância de uma classe filho correspondente ao tipo específico do objeto de imagem recuperado.

Um objeto Image é usado para implantar um usuário Model 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.

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 Ambiente classe para definir a imagem. Em seguida, você pode usar o objeto de ambiente com o Model deploy() método para implantar o modelo como um serviço Web. Você também pode usar o package() método Model para criar uma imagem que possa ser baixada em 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 marcas à imagem.

create

Crie uma imagem no espaço de trabalho fornecido.

delete

Exclua uma imagem de seu espaço de trabalho correspondente.

deserialize

Converta um objeto JSON em um objeto Image.

image_configuration

Método abstract 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 marcas da imagem.

serialize

Converter este objeto de imagem 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. Útil principalmente para sondagem manual do estado de criação.

wait_for_creation

Aguarde até que a imagem termine de ser criada.

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

add_properties

Adicione Propriedades à imagem.

add_properties(properties)

Parâmetros

properties
<xref:dict>[<xref:str>, <xref:str>]

Um dicionário de propriedades a ser adicionado.

add_tags

Adicione marcas à imagem.

add_tags(tags)

Parâmetros

tags
<xref:dict>[<xref:str>, <xref:str>]

Um dicionário de marcas a serem adicionadas.

create

Crie uma imagem no espaço de trabalho fornecido.

create(workspace, name, models, image_config)

Parâmetros

workspace
<xref:workspace: azureml.core.workspace.Workspace>

O espaço de trabalho a ser associado a esta imagem.

name
<xref:str>

O nome a ser associado a esta imagem.

models
list[Model]

Uma lista de objetos de modelo para empacotar com esta imagem. Pode ser uma lista vazia.

image_config
ImageConfig

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

Retornos

O objeto de imagem criado.

Tipo de retorno

delete

Exclua uma imagem de seu espaço de trabalho correspondente.

delete()

Comentários

Esse método falhará se a imagem tiver sido implantada em um WebService ao vivo.

deserialize

Converta um objeto JSON em um objeto Image.

deserialize(workspace, image_payload)

Parâmetros

cls

Indica o método de classe.

workspace
Workspace

O objeto de espaço de trabalho no qual a imagem está registrada.

image_payload
<xref:dict>

Um objeto JSON a ser convertido em um objeto Image.

Retornos

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

Tipo de retorno

Comentários

Esse método falhará se o espaço de trabalho fornecido não for o espaço de trabalho em que a imagem está registrada.

image_configuration

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

image_configuration()

list

Liste as imagens associadas ao espaço de trabalho correspondente. Pode ser filtrado com parâmetros específicos.

list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)

Parâmetros

workspace
Workspace

O objeto de espaço de trabalho no qual listar as imagens.

image_name
<xref:str>
valor padrão: None

Lista de filtros para incluir apenas imagens implantadas com o nome de imagem específico.

model_name
<xref:str>
valor padrão: None

Lista de filtros para incluir apenas imagens implantadas com o nome do modelo específico.

model_id
<xref:str>
valor padrão: None

Lista de filtros 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 ' Key ' ou ' [key, value] '. Exemplo: [' Key ', [' Key2 ', ' Key2 value ']]

properties
list
valor padrão: None

Filtrará com base na lista fornecida, por ' Key ' ou ' [key, value] '. Exemplo: [' Key ', [' Key2 ', ' Key2 value ']]

Retornos

Uma lista filtrada de imagens no espaço de trabalho fornecido.

Tipo de retorno

list[<xref:Images>]

remove_tags

Remova as marcas da imagem.

remove_tags(tags)

Parâmetros

tags
list[<xref:str>]

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

serialize

Converter este objeto de imagem em um dicionário serializado JSON.

serialize()

Retornos

A representação JSON deste objeto Image.

Tipo de retorno

<xref:dict>

update

Atualize a imagem.

update(tags)

Parâmetros

tags
<xref:dict>[<xref:str>, <xref:str>]

Um dicionário de marcas para atualizar a imagem. Substituirá todas as marcas existentes.

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. Útil principalmente para sondagem manual do estado de criação.

update_creation_state()

wait_for_creation

Aguarde até que a imagem termine de ser criada.

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

wait_for_creation(show_output=False)

Parâmetros

show_output
<xref:bool>
valor padrão: False

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