Image Classe

Define a classe principal abstrata para Imagens do Azure Machine Learning.

Esta classe foi preterida. Em alternativa, utilize a Environment classe .

Construtor de imagens.

Esta classe foi preterida. Em alternativa, utilize a Environment classe .

O construtor de imagens é utilizado para obter uma representação na cloud de um objeto Imagem associado à área de trabalho fornecida. Devolverá uma instância de uma classe subordinada correspondente ao tipo específico do objeto Imagem obtido.

Herança
Image

Construtor

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

Parâmetros

workspace
Workspace
Necessário

O objeto Área de Trabalho que contém a Imagem a obter.

name
str
valor predefinido: None

O nome da Imagem a obter. Irá devolver a versão mais recente da Imagem, se existir.

id
str
valor predefinido: None

O ID específico da Imagem a obter. (O ID é "<name>:<version>")

tags
list
valor predefinido: None

Irá filtrar os Resultados da imagem com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

properties
list
valor predefinido: None

Irá filtrar os Resultados da imagem com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

version
str
valor predefinido: None

Quando a versão e o nome forem especificados, devolverá a versão específica da Imagem.

workspace
Workspace
Necessário

O objeto da área de trabalho que contém a Imagem a obter

name
str
Necessário

O nome da Imagem a obter. Devolverá a versão mais recente, se existir

id
str
Necessário

O ID específico da Imagem a obter. (O ID é ":")

tags
list
Necessário

Irá filtrar os Resultados da imagem com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

properties
list
Necessário

Irá filtrar os Resultados da imagem com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

version
str
Necessário

Quando a versão e o nome forem especificados, devolverá a versão específica da Imagem.

Observações

O construtor Imagem obtém uma representação na cloud de um objeto Imagem associado à área de trabalho fornecida. Devolve uma instância de uma classe subordinada correspondente ao tipo específico do objeto Imagem obtido.

Um objeto Imagem é utilizado para implementar um utilizador Model como um Webservice. Normalmente, o objeto Imagem contém um Modelo, um script de execução e quaisquer dependências necessárias para a implementação do Modelo. A classe Imagem tem várias subclasses, como ContainerImage para Imagens do Docker e Imagens como a FPGA.

Veja a ContainerImage classe para obter um exemplo de uma classe que herda da classe Imagem.

Normalmente, as imagens são utilizadas em fluxos de trabalho que requerem a utilização de uma imagem. Na maioria dos fluxos de trabalho, deve utilizar a Environment classe para definir a sua imagem. Em seguida, pode utilizar o objeto Ambiente com o Modeldeploy() método para implementar o modelo como um serviço Web. Também pode utilizar o método Modelo package() para criar uma imagem que pode ser transferida para a instalação local do Docker como uma imagem ou como um Dockerfile.

Veja a seguinte ligação para obter uma descrição geral sobre como implementar modelos no Azure: https://aka.ms/azureml-how-deploy.

Métodos

add_properties

Adicione propriedades à imagem.

add_tags

Adicione etiquetas à imagem.

create

Crie uma imagem na área de trabalho fornecida.

delete

Eliminar uma imagem da área de trabalho correspondente.

deserialize

Converter um objeto json num objeto Imagem.

image_configuration

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

list

Liste as Imagens associadas à área de trabalho correspondente. Pode ser filtrado com parâmetros específicos.

remove_tags

Remover etiquetas da imagem.

serialize

Converta este objeto Imagem num dicionário serializado JSON.

update

Atualize a imagem.

update_creation_state

Atualize o estado atual do objeto dentro da memória.

Efetue uma atualização no local das propriedades do objeto com base no estado atual do objeto de cloud correspondente. Principalmente útil para consulta manual do estado de criação.

wait_for_creation

Aguarde que a imagem conclua a criação.

Aguarde que a criação da imagem atinja um estado terminal. Emitirá um WebserviceException se atingir um estado de terminal sem êxito.

add_properties

Adicione propriedades à imagem.

add_properties(properties)

Parâmetros

properties
dict[str, str]
Necessário

Um dicionário de propriedades a adicionar.

Exceções

add_tags

Adicione etiquetas à imagem.

add_tags(tags)

Parâmetros

tags
dict[str, str]
Necessário

Um dicionário de etiquetas a adicionar.

Exceções

create

Crie uma imagem na área de trabalho fornecida.

static create(workspace, name, models, image_config)

Parâmetros

workspace
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
Necessário

A área de trabalho a associar a esta imagem.

name
str
Necessário

O nome a associar a esta imagem.

models
list[Model]
Necessário

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

image_config
ImageConfig
Necessário

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

Devoluções

O objeto Imagem criado.

Tipo de retorno

Exceções

delete

Eliminar uma imagem da área de trabalho correspondente.

delete()

Exceções

Observações

Este método falha se a imagem tiver sido implementada num webservice em direto.

deserialize

Converter um objeto json num objeto Imagem.

deserialize(workspace, image_payload)

Parâmetros

cls
Necessário

Indica o método de classe.

workspace
Workspace
Necessário

O objeto da área de trabalho em que a Imagem está registada.

image_payload
dict
Necessário

Um objeto JSON para converter num objeto Imagem.

Devoluções

A Representação da imagem do objeto JSON fornecido.

Tipo de retorno

Exceções

Observações

Este método falha se a área de trabalho fornecida não for a área de trabalho na qual a imagem está registada.

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 à área 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

workspace
Workspace
Necessário

O objeto Área de Trabalho no qual listar as Imagens.

image_name
str
valor predefinido: None

Filtre a lista para incluir apenas Imagens implementadas com o nome de imagem específico.

model_name
str
valor predefinido: None

Filtre a lista para incluir apenas Imagens implementadas com o nome de modelo específico.

model_id
str
valor predefinido: None

Filtre a lista para incluir apenas Imagens implementadas com o ID de modelo específico.

tags
list
valor predefinido: None

Irá filtrar com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

properties
list
valor predefinido: None

Irá filtrar com base na lista fornecida, por "chave" ou "[chave, valor]". Por exemplo: ['key', ['key2', 'key2 value']]

Devoluções

Uma lista filtrada de Imagens na área de trabalho fornecida.

Tipo de retorno

list[<xref:Images>]

Exceções

remove_tags

Remover etiquetas da imagem.

remove_tags(tags)

Parâmetros

tags
list[str]
Necessário

Uma lista de chaves correspondentes a etiquetas a serem removidas.

Exceções

serialize

Converta este objeto Imagem num dicionário serializado JSON.

serialize()

Devoluções

A representação JSON deste objeto Imagem.

Tipo de retorno

Exceções

update

Atualize a imagem.

update(tags)

Parâmetros

tags
dict[str, str]
Necessário

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

Exceções

update_creation_state

Atualize o estado atual do objeto dentro da memória.

Efetue uma atualização no local das propriedades do objeto com base no estado atual do objeto de cloud correspondente. Principalmente útil para consulta manual do estado de criação.

update_creation_state()

Exceções

wait_for_creation

Aguarde que a imagem conclua a criação.

Aguarde que a criação da imagem atinja um estado terminal. Emitirá um WebserviceException se atingir um estado de terminal sem êxito.

wait_for_creation(show_output=False)

Parâmetros

show_output
bool
valor predefinido: False

Opção booleana para imprimir uma saída mais verbosa. A predefinição é Falso.

Exceções