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 de imágenes 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
- workspace
- Workspace
El objeto de área de trabajo que contiene la imagen que se va a recuperar.
- name
- str
El nombre de la imagen que se va a recuperar. Devolverá la versión más reciente de la imagen, si existe.
- id
- str
El identificador específico de la imagen que se va a recuperar. (El identificador es "<name>:<version>")
- tags
- list
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["calve2", "valor de clave2"]]
- properties
- list
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["clave2", "valor de clave2"]]
- version
- str
Cuando se especifican la versión y el nombre, devolverá la versión específica de la imagen.
- workspace
- Workspace
Objeto del área de trabajo que contiene la imagen que se va a recuperar.
- name
- str
El nombre de la imagen que se va a recuperar. Devolverá la versión más reciente, si existe.
- id
- str
El identificador específico de la imagen que se va a recuperar. (El identificador es ":")
- tags
- list
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["calve2", "valor de clave2"]]
- properties
- list
Filtrará los resultados de la imagen en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["clave2", "valor de clave2"]]
- version
- str
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. Después, puede usar el objeto Environment con el método Modeldeploy() 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 |
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
Excepciones
add_tags
Agrega etiquetas a la imagen.
add_tags(tags)Parámetros
Excepciones
create
Crea una imagen en el área de trabajo proporcionada.
static create(workspace, name, models, image_config)Parámetros
- workspace
- <xref:<xref:workspace: azureml.core.workspace.Workspace>>
Área de trabajo que se va a asociar a esta imagen.
Lista de objetos Model que se empaquetan con esta imagen. Puede ser una lista vacía.
- image_config
- ImageConfig
Objeto de configuración de imagen que se va a usar para configurar esta imagen.
Devoluciones
El objeto Image creado.
Tipo de valor devuelto
Excepciones
delete
Elimina una imagen de su área de trabajo correspondiente.
delete()Excepciones
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
- cls
Indica el método de clase.
Devoluciones
La representación de la imagen del objeto JSON proporcionado.
Tipo de valor devuelto
Excepciones
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
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
- image_name
- str
Filtra la lista para que incluya solo imágenes implementadas con el nombre de imagen específico.
- model_name
- str
Filtra la lista para que incluya solo imágenes implementadas con el nombre del modelo específico.
- model_id
- str
Filtra la lista para que incluya solo imágenes implementadas con el identificador del modelo específico.
- tags
- list
Filtrará los resultados en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["clave2", "valor de clave2"]]
- properties
- list
Filtrará los resultados en función de la lista proporcionada, ya sea por "clave" o "[clave, valor]". Por ejemplo, ["clave", ["clave2", "valor de clave2"]]
Devoluciones
Una lista filtrada de imágenes en el área de trabajo proporcionada.
Tipo de valor devuelto
Excepciones
remove_tags
Elimina las etiquetas de la imagen.
remove_tags(tags)Parámetros
Una lista de claves correspondientes a las etiquetas que se van a eliminar.
Excepciones
serialize
Convierte este objeto de imagen en un diccionario serializado JSON.
serialize()Devoluciones
La representación JSON de este objeto de imagen.
Tipo de valor devuelto
Excepciones
update
Actualiza la imagen.
update(tags)Parámetros
Un diccionario de etiquetas con las que actualizar la imagen. Sobrescribirá todas las etiquetas existentes.
Excepciones
update_creation_state
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
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
- show_output
- bool
Opción booleana para imprimir una salida más detallada. El valor predeterminado es False.
Excepciones
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de