Image Clase
Define la clase principal abstracta de las imágenes de Azure Machine Learning.
Esta clase está en DESUSO. Utilice la clase Environment en su lugar.
Constructor de imagen.
Esta clase está en DESUSO. Utilice la clase Environment en su lugar.
El constructor image se usa para recuperar una representación en la nube de un objeto Image asociado al área de trabajo proporcionada. Devolverá una instancia de una clase secundaria correspondiente al tipo específico del objeto Image recuperado.
- Herencia
-
Image
Constructor
Image(workspace, name=None, id=None, tags=None, properties=None, version=None)Parámetros
| Nombre | Description |
|---|---|
|
workspace
Requerido
|
El objeto de área de trabajo que contiene la imagen que se va a recuperar. |
|
name
|
El nombre de la imagen que se va a recuperar. Devolverá la versión más reciente de la imagen, si existe. Valor predeterminado: None
|
|
id
|
El identificador específico de la imagen que se va a recuperar. (El identificador es "<name>:<version>") Valor predeterminado: None
|
|
tags
|
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] Valor predeterminado: None
|
|
properties
|
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] Valor predeterminado: None
|
|
version
|
Cuando se especifican la versión y el nombre, devolverá la versión específica de la imagen. Valor predeterminado: None
|
|
workspace
Requerido
|
Objeto de área de trabajo que contiene la imagen que se va a recuperar |
|
name
Requerido
|
El nombre de la imagen que se va a recuperar. Devolverá la versión más reciente, si existe. |
|
id
Requerido
|
El identificador específico de la imagen que se va a recuperar. (Id. es ":") |
|
tags
Requerido
|
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] |
|
properties
Requerido
|
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] |
|
version
Requerido
|
Cuando se especifican la versión y el nombre, devolverá la versión específica de la imagen. |
Comentarios
El constructor de imagen recupera una representación en la nube de un objeto de imagen asociado al área de trabajo proporcionada. Devuelve una instancia de una clase secundaria correspondiente al tipo específico del objeto de imagen recuperado.
Un objeto de imagen se usa para implementar el valor de Model de un usuario como Webservice. El objeto Image normalmente contiene un modelo, un script de ejecución y las dependencias necesarias para la implementación del modelo. La clase Image tiene varias subclases, como ContainerImage para imágenes de Docker, e imágenes como FPGA.
Consulte la clase ContainerImage para obtener un ejemplo de una clase que se hereda de la clase Image.
Las imágenes se usan normalmente en flujos de trabajo que requieren el uso de una imagen. Para la mayoría de los flujos de trabajo, en su lugar debe usar la clase Environment para definir la imagen. A continuación, puede usar el objeto Environment con el Model deploy() método para implementar el modelo como un servicio web.
También puede usar el método Model package() para crear una imagen que se puede descargar en la instalación local de Docker como una imagen o como Dockerfile.
Consulte el vínculo siguiente para información general sobre la implementación de modelos en Azure: https://aka.ms/azureml-how-deploy.
Métodos
| add_properties |
Agrega propiedades a la imagen. |
| add_tags |
Agrega etiquetas a la imagen. |
| create |
Crea una imagen en el área de trabajo proporcionada. |
| delete |
Elimina una imagen de su área de trabajo correspondiente. |
| deserialize |
Convierte un objeto JSON en un objeto de imagen. |
| image_configuration |
Método abstracto para crear un objeto de configuración de imagen. |
| list |
Muestra las imágenes asociadas al área de trabajo correspondiente. Se puede filtrar con parámetros específicos. |
| remove_tags |
Elimina las etiquetas de la imagen. |
| serialize |
Convierte este objeto de imagen en un diccionario serializado JSON. |
| update |
Actualiza la imagen. |
| update_creation_state |
Se actualiza el estado actual del objeto en memoria. Realiza una actualización local de las propiedades del objeto en función del estado actual del objeto de nube correspondiente. Principalmente útil para el sondeo manual del estado de creación. |
| wait_for_creation |
Espera a que la imagen termine de crearse. Espera a que la creación de la imagen alcance un estado terminal. Producirá una excepción WebserviceException si alcanza un estado terminal no correcto. |
add_properties
Agrega propiedades a la imagen.
add_properties(properties)Parámetros
| Nombre | Description |
|---|---|
|
properties
Requerido
|
Diccionario de las propiedades que se van a agregar. |
Excepciones
| Tipo | Description |
|---|---|
add_tags
Agrega etiquetas a la imagen.
add_tags(tags)Parámetros
| Nombre | Description |
|---|---|
|
tags
Requerido
|
Diccionario de las etiquetas que se van a agregar. |
Excepciones
| Tipo | Description |
|---|---|
create
Crea una imagen en el área de trabajo proporcionada.
static create(workspace, name, models, image_config)Parámetros
| Nombre | Description |
|---|---|
|
workspace
Requerido
|
<xref:<xref:workspace: azureml.core.workspace.Workspace>>
Área de trabajo que se va a asociar a esta imagen. |
|
name
Requerido
|
Nombre que se va a asociar a esta imagen. |
|
models
Requerido
|
Lista de objetos Model que se empaquetan con esta imagen. Puede ser una lista vacía. |
|
image_config
Requerido
|
Objeto de configuración de imagen que se va a usar para configurar esta imagen. |
Devoluciones
| Tipo | Description |
|---|---|
|
El objeto Image creado. |
Excepciones
| Tipo | Description |
|---|---|
delete
Elimina una imagen de su área de trabajo correspondiente.
delete()Excepciones
| Tipo | Description |
|---|---|
Comentarios
Se produce un error en este método si la imagen se ha implementado en un servicio web en directo.
deserialize
Convierte un objeto JSON en un objeto de imagen.
deserialize(workspace, image_payload)Parámetros
| Nombre | Description |
|---|---|
|
cls
Requerido
|
Indica el método de clase. |
|
workspace
Requerido
|
Objeto de área de trabajo en el que está registrada la imagen. |
|
image_payload
Requerido
|
Objeto JSON que se va a convertir en un objeto Image. |
Devoluciones
| Tipo | Description |
|---|---|
|
La representación de la imagen del objeto JSON proporcionado. |
Excepciones
| Tipo | Description |
|---|---|
Comentarios
Este método produce un error si el área de trabajo proporcionada no es el área de trabajo en la que está registrada la imagen.
image_configuration
Método abstracto para crear un objeto de configuración de imagen.
abstract static image_configuration()Excepciones
| Tipo | Description |
|---|---|
list
Muestra las imágenes asociadas al área de trabajo correspondiente. Se puede filtrar con parámetros específicos.
static list(workspace, image_name=None, model_name=None, model_id=None, tags=None, properties=None)Parámetros
| Nombre | Description |
|---|---|
|
workspace
Requerido
|
El objeto de área de trabajo en el que se muestran las imágenes. |
|
image_name
|
Filtra la lista para que incluya solo imágenes implementadas con el nombre de imagen específico. Valor predeterminado: None
|
|
model_name
|
Filtra la lista para que incluya solo imágenes implementadas con el nombre del modelo específico. Valor predeterminado: None
|
|
model_id
|
Filtra la lista para que incluya solo imágenes implementadas con el identificador del modelo específico. Valor predeterminado: None
|
|
tags
|
Filtrará los resultados en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] Valor predeterminado: None
|
|
properties
|
Filtrará los resultados en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Ejemplo: ["clave", ["clave2", "valor de clave2"]] Valor predeterminado: None
|
Devoluciones
| Tipo | Description |
|---|---|
|
list[<xref:Images>]
|
Una lista filtrada de imágenes en el área de trabajo proporcionada. |
Excepciones
| Tipo | Description |
|---|---|
remove_tags
Elimina las etiquetas de la imagen.
remove_tags(tags)Parámetros
| Nombre | Description |
|---|---|
|
tags
Requerido
|
Una lista de claves correspondientes a las etiquetas que se van a eliminar. |
Excepciones
| Tipo | Description |
|---|---|
serialize
Convierte este objeto de imagen en un diccionario serializado JSON.
serialize()Devoluciones
| Tipo | Description |
|---|---|
|
La representación JSON de este objeto de imagen. |
Excepciones
| Tipo | Description |
|---|---|
update
Actualiza la imagen.
update(tags)Parámetros
| Nombre | Description |
|---|---|
|
tags
Requerido
|
Un diccionario de etiquetas con las que actualizar la imagen. Sobrescribirá todas las etiquetas existentes. |
Excepciones
| Tipo | Description |
|---|---|
update_creation_state
Se actualiza el estado actual del objeto en memoria.
Realiza una actualización local de las propiedades del objeto en función del estado actual del objeto de nube correspondiente. Principalmente útil para el sondeo manual del estado de creación.
update_creation_state()Excepciones
| Tipo | Description |
|---|---|
wait_for_creation
Espera a que la imagen termine de crearse.
Espera a que la creación de la imagen alcance un estado terminal. Producirá una excepción WebserviceException si alcanza un estado terminal no correcto.
wait_for_creation(show_output=False)Parámetros
| Nombre | Description |
|---|---|
|
show_output
|
Opción booleana para imprimir una salida más detallada. El valor predeterminado es False. Valor predeterminado: False
|
Excepciones
| Tipo | Description |
|---|---|