CloudJob Classe

Processo Azure Batch.

Ereditarietà

Model

CloudJob

Costruttore

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)

Parametri

id

str

Necessario

L'ID mantiene le maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID all'interno di un account che differisce solo per caso.

display_name

str

Necessario

uses_task_dependencies

bool

Necessario

Indica se le attività nel processo possono definire le dipendenze l'una dall'altra. Il valore predefinito è false.

url

str

Necessario

e_tag

str

Necessario

Si tratta di una stringa opaca. È possibile usarlo per rilevare se il processo è cambiato tra le richieste. In particolare, è possibile passare l'ETag durante l'aggiornamento di un processo per specificare che le modifiche devono essere applicate solo se nessun altro ha modificato il processo nel frattempo.

last_modified

datetime

Necessario

Si tratta dell'ultima volta in cui i dati a livello di processo, ad esempio lo stato del processo o la priorità, sono stati modificati. Non influisce su modifiche a livello di attività, ad esempio l'aggiunta di nuove attività o attività che cambiano lo stato.

creation_time

datetime

Necessario

state

str oppure JobState

Necessario

Stato corrente del processo. I valori possibili includono: 'active', 'disableing', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'

state_transition_time

datetime

Necessario

previous_state

str oppure JobState

Necessario

Stato precedente del processo. Questa proprietà non è impostata se il processo si trova nello stato Attivo iniziale. I valori possibili includono: 'active', 'disableing', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'

previous_state_transition_time

datetime

Necessario

Questa proprietà non è impostata se il processo si trova nello stato Attivo iniziale.

priority

int

Necessario

Priorità del processo. I valori della priorità possono essere compresi tra -1000 e 1000, dove -1000 è la priorità più bassa e 1000 la priorità più alta. Il valore predefinito è 0.

allow_task_preemption

bool

Necessario

Indica se le attività in questo processo possono essere annullate da altri processi con priorità elevata. Se il valore è impostato su True, gli altri processi con priorità alta inviati al sistema avranno la precedenza e potranno rieseguere le attività da questo processo. È possibile aggiornare allowTaskPreemption di un processo dopo che è stato creato usando l'API del processo di aggiornamento.

max_parallel_tasks

int

Necessario

Numero massimo di attività che è possibile eseguire in parallelo per il processo. Il valore di maxParallelTasks deve essere -1 o maggiore di 0 se specificato. Se non specificato, il valore predefinito è -1, ovvero non esiste alcun limite al numero di attività che possono essere eseguite contemporaneamente. È possibile aggiornare il valore maxParallelTasks di un processo dopo che è stato creato usando l'API del processo di aggiornamento. Valore predefinito: -1 .

constraints

JobConstraints

Necessario

Vincoli di esecuzione per il processo.

job_manager_task

JobManagerTask

Necessario

Dettagli di un'attività di Gestione processi da avviare all'avvio del processo.

job_preparation_task

JobPreparationTask

Necessario

Attività di preparazione del processo. L'attività preparazione processo è un'attività speciale eseguita in ogni nodo di calcolo prima di qualsiasi altra attività del processo.

job_release_task

JobReleaseTask

Necessario

Attività Rilascio processo. L'attività Rilascio processo è un'attività speciale eseguita alla fine del processo in ogni nodo di calcolo che ha eseguito qualsiasi altra attività del processo.

common_environment_settings

list[EnvironmentSetting]

Necessario

Le singole attività possono eseguire l'override di un'impostazione di ambiente specificata qui specificando lo stesso nome di impostazione con un valore diverso.

pool_info

PoolInformation

Necessario

Impostazioni pool associate al processo.

on_all_tasks_complete

str oppure OnAllTasksComplete

Necessario

L'azione che il servizio Batch deve eseguire quando tutte le attività nel processo sono nello stato completato. Il valore predefinito è noaction. I valori possibili includono: 'noAction', 'terminateJob'

on_task_failure

str oppure OnTaskFailure

Necessario

L'azione che il servizio Batch deve eseguire quando un'attività nel processo ha esito negativo. Un'attività viene considerata non riuscita se ha un valore failureInfo. Un failureInfo viene impostato se l'attività viene completata con un codice di uscita diverso da zero dopo aver esaurito il numero di tentativi oppure se si è verificato un errore durante l'avvio dell'attività, ad esempio a causa di un errore di download del file di risorse. Il valore predefinito è noaction. I valori possibili includono: 'noAction', 'performExitOptionsJobAction'

network_configuration

JobNetworkConfiguration

Necessario

Configurazione di rete per il processo.

metadata

list[MetadataItem]

Necessario

Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

execution_info

JobExecutionInformation

Necessario

Informazioni sull'esecuzione per il processo.

stats

JobStatistics

Necessario

Statistiche di utilizzo delle risorse per l'intera durata del processo. Questa proprietà viene popolata solo se CloudJob è stato recuperato con una clausola expand, incluso l'attributo 'stats'; in caso contrario, è Null. Le statistiche potrebbero non essere immediatamente disponibili. Il servizio Batch esegue un rollup periodico delle statistiche. Il ritardo tipico è di circa 30 minuti.

Metodi

as_dict	Restituire un dict che può essere JSONify usando json.dump. L'utilizzo avanzato può facoltativamente usare un callback come parametro: Key è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Value è il valore corrente in questo oggetto. La stringa restituita verrà utilizzata per serializzare la chiave. Se il tipo restituito è un elenco, si tratta di un risultato gerarchico dict. Vedere i tre esempi in questo file: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Se si desidera la serializzazione XML, è possibile passare i kwargs is_xml=True.
deserialize	Analizzare uno str usando la sintassi RestAPI e restituire un modello.
enable_additional_properties_sending
from_dict	Analizzare un dict usando un estrattore di chiave specificato restituisce un modello. Per impostazione predefinita, considerare gli estrattori di chiave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Restituire il codice JSON che verrebbe inviato ad Azure da questo modello. Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False). Se si desidera la serializzazione XML, è possibile passare i kwargs is_xml=True.
validate	Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

as_dict

Restituire un dict che può essere JSONify usando json.dump.

L'utilizzo avanzato può facoltativamente usare un callback come parametro:

Key è il nome dell'attributo usato in Python. Attr_desc è un dict di metadati. Attualmente contiene 'type' con il tipo msrest e 'key' con la chiave con codifica RestAPI. Value è il valore corrente in questo oggetto.

La stringa restituita verrà utilizzata per serializzare la chiave. Se il tipo restituito è un elenco, si tratta di un risultato gerarchico dict.

Vedere i tre esempi in questo file:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Se si desidera la serializzazione XML, è possibile passare i kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Parametri

key_transformer

<xref:function>

Funzione di trasformatore di tasti.

keep_readonly

valore predefinito: True

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

dict

deserialize

Analizzare uno str usando la sintassi RestAPI e restituire un modello.

deserialize(data, content_type=None)

Parametri

data

str

Necessario

Str che usa la struttura RestAPI. JSON per impostazione predefinita.

content_type

str

valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Analizzare un dict usando un estrattore di chiave specificato restituisce un modello.

Per impostazione predefinita, considerare gli estrattori di chiave (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor e last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Parametri

data

dict

Necessario

Oggetto dict using RestAPI structure (Struttura RESTAPI)

content_type

str

valore predefinito: None

JSON per impostazione predefinita, impostare application/xml se XML.

key_extractors

valore predefinito: None

Restituisce

Istanza di questo modello

Eccezioni

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Restituire il codice JSON che verrebbe inviato ad Azure da questo modello.

Si tratta di un alias per as_dict(full_restapi_key_transformer, keep_readonly=False).

Se si desidera la serializzazione XML, è possibile passare i kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametri

keep_readonly

bool

valore predefinito: False

Se si desidera serializzare gli attributi readonly

Restituisce

Oggetto compatibile con JSON dict

Tipo restituito

dict

validate

Convalidare questo modello in modo ricorsivo e restituire un elenco di ValidationError.

validate()

Restituisce

Elenco di errori di convalida

Tipo restituito

list