Compartir a través de


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
Requerido

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
Requerido
uses_task_dependencies
bool
Requerido

Si las tareas del trabajo pueden definir dependencias entre sí. El valor predeterminado es false.

url
str
Requerido
e_tag
str
Requerido

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
Requerido

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
Requerido
state
str o JobState
Requerido

Estado actual del trabajo. Entre los valores posibles se incluyen: 'active', 'disabled', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'

state_transition_time
datetime
Requerido
previous_state
str o JobState
Requerido

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
Requerido

Esta propiedad no se establece si el trabajo está en su estado activo inicial.

priority
int
Requerido

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
Requerido

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
Requerido

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 .

constraints
JobConstraints
Requerido

Restricciones de ejecución para el trabajo.

job_manager_task
JobManagerTask
Requerido

Detalles de una tarea del Administrador de trabajos que se va a iniciar cuando se inicia el trabajo.

job_preparation_task
JobPreparationTask
Requerido

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
Requerido

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]
Requerido

Las tareas individuales pueden invalidar una configuración de entorno especificada aquí especificando el mismo nombre de configuración con un valor diferente.

pool_info
PoolInformation
Requerido

Configuración del grupo asociada al trabajo.

on_all_tasks_complete
str o OnAllTasksComplete
Requerido

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
Requerido

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".

network_configuration
JobNetworkConfiguration
Requerido

Configuración de red para el trabajo.

metadata
list[MetadataItem]
Requerido

El servicio Batch no asigna ningún significado a los metadatos; es únicamente para el uso del código de usuario.

execution_info
JobExecutionInformation
Requerido

Información de ejecución del trabajo.

stats
JobStatistics
Requerido

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:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

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
valor predeterminado: True

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
Requerido

Una cadena de datos mediante la estructura restAPI. JSON de forma predeterminada.

content_type
str
valor predeterminado: None

JSON de forma predeterminada, establezca application/xml si XML.

Devoluciones

Una instancia de este modelo

Excepciones

DeserializationError if something went wrong

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

data
dict
Requerido

Un dict mediante la estructura restAPI

content_type
str
valor predeterminado: None

JSON de forma predeterminada, establezca application/xml si XML.

key_extractors
valor predeterminado: None

Devoluciones

Una instancia de este modelo

Excepciones

DeserializationError if something went wrong

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

keep_readonly
bool
valor predeterminado: False

Si desea serializar los atributos de solo lectura

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