CloudJob Clase
Un trabajo de Azure Batch.
- Herencia
-
CloudJob
Constructor
CloudJob(*, id: str = None, display_name: str = None, uses_task_dependencies: bool = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, previous_state=None, previous_state_transition_time=None, priority: int = None, allow_task_preemption: bool = None, max_parallel_tasks: int = -1, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, pool_info=None, on_all_tasks_complete=None, on_task_failure=None, network_configuration=None, metadata=None, execution_info=None, stats=None, **kwargs)Parámetros
- id
- str
El identificador se conserva entre mayúsculas y minúsculas y no distingue mayúsculas de minúsculas (es decir, es posible que no tenga dos identificadores dentro de una cuenta que solo difieren por mayúsculas y minúsculas).
- display_name
- str
- uses_task_dependencies
- bool
Si las tareas del trabajo pueden definir dependencias entre sí. El valor predeterminado es false.
- url
- str
- e_tag
- str
Se trata de una cadena opaca. Puede usarlo para detectar si el trabajo ha cambiado entre solicitudes. En concreto, puede pasar la ETag al actualizar un trabajo para especificar que los cambios deben surtir efecto solo si nadie más ha modificado el trabajo mientras tanto.
- last_modified
- datetime
Esta es la última vez en la que cambiaron los datos de nivel de trabajo, como el estado o la prioridad del trabajo. No tiene en cuenta los cambios en el nivel de tarea, como agregar nuevas tareas o tareas que cambian de estado.
- creation_time
- datetime
Estado actual del trabajo. Entre los valores posibles se incluyen: 'active', 'disabled', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'
- state_transition_time
- datetime
Estado anterior del trabajo. Esta propiedad no se establece si el trabajo está en su estado activo inicial. Entre los valores posibles se incluyen: 'active', 'disabled', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'
- previous_state_transition_time
- datetime
Esta propiedad no se establece si el trabajo está en su estado activo inicial.
- priority
- int
Prioridad del trabajo. Los valores de prioridad pueden oscilar entre -1000 y 1000, siendo -1000 la prioridad más baja y 1000 la prioridad más alta. El valor predeterminado es 0.
- allow_task_preemption
- bool
Si las tareas de este trabajo pueden ser adelantadas por otros trabajos de prioridad alta. Si el valor se establece en True, otros trabajos de prioridad alta enviados al sistema tendrán prioridad y podrán volver a poner en cola las tareas de este trabajo. Puede actualizar allowTaskPreemption de un trabajo después de que se haya creado mediante la API de trabajo de actualización.
- max_parallel_tasks
- int
Número máximo de tareas que se pueden ejecutar en paralelo para el trabajo. El valor de maxParallelTasks debe ser -1 o mayor que 0 si se especifica. Si no se especifica, el valor predeterminado es -1, lo que significa que no hay ningún límite para el número de tareas que se pueden ejecutar a la vez. Puede actualizar maxParallelTasks de un trabajo una vez creado mediante la API de trabajo de actualización. Valor predeterminado: -1 .
- job_manager_task
- JobManagerTask
Detalles de una tarea del Administrador de trabajos que se va a iniciar cuando se inicia el trabajo.
- job_preparation_task
- JobPreparationTask
Tarea de preparación del trabajo. La tarea de preparación del trabajo es una tarea especial que se ejecuta en cada nodo de proceso antes de cualquier otra tarea del trabajo.
- job_release_task
- JobReleaseTask
Tarea De liberación del trabajo. La tarea de liberación de trabajos es una tarea especial que se ejecuta al final del trabajo en cada nodo de ejecución que haya ejecutado cualquier otra tarea del trabajo.
- common_environment_settings
- list[EnvironmentSetting]
Las tareas individuales pueden invalidar una configuración de entorno especificada aquí especificando el mismo nombre de configuración con un valor diferente.
- on_all_tasks_complete
- str o OnAllTasksComplete
La acción que debe realizar el servicio Batch cuando todas las tareas del trabajo están en estado completado. El valor predeterminado es noaction. Entre los valores posibles se incluyen: 'noAction', 'terminateJob'
- on_task_failure
- str o OnTaskFailure
La acción que el servicio Batch debe realizar cuando se produce un error en cualquier tarea del trabajo. Se considera que se ha producido un error en una tarea si tiene un failureInfo. Se establece un errorInfo si la tarea se completa con un código de salida distinto de cero después de agotar su recuento de reintentos, o si se produjo un error al iniciar la tarea, por ejemplo debido a un error de descarga del archivo de recursos. El valor predeterminado es noaction. Entre los valores posibles se incluyen: "noAction", "performExitOptionsJobAction".
- metadata
- list[MetadataItem]
El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.
- stats
- JobStatistics
Estadísticas de uso de recursos para toda la duración del trabajo. Esta propiedad solo se rellena si cloudJob se recuperó con una cláusula expand, incluido el atributo 'stats'; de lo contrario, es null. Es posible que las estadísticas no estén disponibles inmediatamente. El servicio Batch realiza una acumulación periódica de estadísticas. El retraso típico es de aproximadamente 30 minutos.
Métodos
| as_dict |
Devuelve un dict que puede ser JSONify mediante json.dump. El uso avanzado podría usar opcionalmente una devolución de llamada como parámetro: Key es el nombre de atributo que se usa en Python. Attr_desc es un dict de metadatos. Actualmente contiene 'type' con el tipo msrest y 'key' con la clave codificada restAPI. Value es el valor actual de este objeto. La cadena devuelta se usará para serializar la clave. Si el tipo de valor devuelto es una lista, se considera dict de resultados jerárquicos. Consulte los tres ejemplos de este archivo:
Si desea serialización XML, puede pasar los kwargs is_xml=True. |
| deserialize |
Analice una cadena mediante la sintaxis restAPI y devuelva un modelo. |
| enable_additional_properties_sending | |
| from_dict |
Analizar un dict mediante un extractor de claves dado devuelve un modelo. De forma predeterminada, considere la posibilidad de extractores de claves (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor y last_rest_key_case_insensitive_extractor) |
| is_xml_model | |
| serialize |
Devuelve el JSON que se enviaría a Azure desde este modelo. Se trata de un alias para as_dict(full_restapi_key_transformer, keep_readonly=False). Si desea serialización XML, puede pasar los kwargs is_xml=True. |
| validate |
Valide este modelo de forma recursiva y devuelva una lista de ValidationError. |
as_dict
Devuelve un dict que puede ser JSONify mediante json.dump.
El uso avanzado podría usar opcionalmente una devolución de llamada como parámetro:
Key es el nombre de atributo que se usa en Python. Attr_desc es un dict de metadatos. Actualmente contiene 'type' con el tipo msrest y 'key' con la clave codificada restAPI. Value es el valor actual de este objeto.
La cadena devuelta se usará para serializar la clave. Si el tipo de valor devuelto es una lista, se considera dict de resultados jerárquicos.
Consulte los tres ejemplos de este archivo:
attribute_transformer
full_restapi_key_transformer
last_restapi_key_transformer
Si desea serialización XML, puede pasar los kwargs is_xml=True.
as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)Parámetros
- key_transformer
- <xref:function>
Una función de transformador de teclas.
- keep_readonly
Devoluciones
Un objeto compatible con JSON dict
Tipo de valor devuelto
deserialize
Analice una cadena mediante la sintaxis restAPI y devuelva un modelo.
deserialize(data, content_type=None)Parámetros
- data
- str
Una cadena de datos mediante la estructura restAPI. JSON de forma predeterminada.
- content_type
- str
JSON de forma predeterminada, establezca application/xml si XML.
Devoluciones
Una instancia de este modelo
Excepciones
enable_additional_properties_sending
enable_additional_properties_sending()from_dict
Analizar un dict mediante un extractor de claves dado devuelve un modelo.
De forma predeterminada, considere la posibilidad de extractores de claves (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor y last_rest_key_case_insensitive_extractor)
from_dict(data, key_extractors=None, content_type=None)Parámetros
- content_type
- str
JSON de forma predeterminada, establezca application/xml si XML.
- key_extractors
Devoluciones
Una instancia de este modelo
Excepciones
is_xml_model
is_xml_model()serialize
Devuelve el JSON que se enviaría a Azure desde este modelo.
Se trata de un alias para as_dict(full_restapi_key_transformer, keep_readonly=False).
Si desea serialización XML, puede pasar los kwargs is_xml=True.
serialize(keep_readonly=False, **kwargs)Parámetros
Devoluciones
Un objeto compatible con JSON dict
Tipo de valor devuelto
validate
Valide este modelo de forma recursiva y devuelva una lista de ValidationError.
validate()Devoluciones
Una lista de errores de validación
Tipo de valor devuelto
Azure SDK for Python
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