JobAddParameter Classe

Processo Azure Batch da aggiungere.

Tutti i parametri obbligatori devono essere popolati per l'invio ad Azure.

Ereditarietà

Model

JobAddParameter

Costruttore

JobAddParameter(*, id: str, pool_info, display_name: str = None, priority: int = None, max_parallel_tasks: int = -1, allow_task_preemption: bool = None, constraints=None, job_manager_task=None, job_preparation_task=None, job_release_task=None, common_environment_settings=None, on_all_tasks_complete=None, on_task_failure=None, metadata=None, uses_task_dependencies: bool = None, network_configuration=None, **kwargs)

Parametri

id

str

Necessario

Obbligatorio. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. 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

Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

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.

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 .

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.

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. Se il processo non specifica un'attività di Gestione processi, l'utente deve aggiungere in modo esplicito attività al processo. Se il processo specifica un'attività di Gestione processi, il servizio Batch crea l'attività di Gestione processi quando viene creato il processo e tenterà di pianificare l'attività di Gestione processi prima di pianificare altre attività nel processo. Lo scopo tipico dell'attività di Gestione processi è controllare e/o monitorare l'esecuzione del processo, ad esempio decidendo quali attività aggiuntive eseguire, determinare quando il lavoro è completo e così via. Tuttavia, un'attività di Gestione processi non è limitata a queste attività. Si tratta di un'attività completamente entità nel sistema e di eseguire qualsiasi azione necessaria per il processo. Ad esempio, un'attività di Gestione processi potrebbe scaricare un file specificato come parametro, analizzare il contenuto del file e inviare attività aggiuntive in base a tali contenuti.

job_preparation_task

JobPreparationTask

Necessario

Attività di preparazione del processo. Se un processo dispone di un'attività di preparazione processo, il servizio Batch eseguirà l'attività preparazione processo in un nodo prima di avviare qualsiasi attività del processo nel nodo di calcolo.

job_release_task

JobReleaseTask

Necessario

Attività Rilascio processo. Non è possibile specificare un'attività di rilascio processo senza specificare anche un'attività di preparazione processo per il processo. Il servizio Batch esegue l'attività Rilascio processo nei nodi che hanno eseguito l'attività preparazione processo. Lo scopo principale dell'attività di rilascio del processo è annullare le modifiche apportate ai nodi di calcolo eseguiti dall'attività preparazione processo. Le attività di esempio includono l'eliminazione di file locali o l'arresto dei servizi avviati come parte della preparazione 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

Obbligatorio. Pool in cui il servizio Batch esegue le attività del 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. Si noti che se un processo non contiene attività, tutte le attività vengono considerate complete. Questa opzione viene quindi usata più comunemente con un'attività di Gestione processi; Se si vuole usare la terminazione automatica del processo senza Gestione processi, è necessario impostare inizialmente onAllTasksComplete su noaction e aggiornare le proprietà job per impostare onAllTasksComplete su terminatejob al termine dell'aggiunta di Attività. 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'

metadata

list[MetadataItem]

Necessario

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

uses_task_dependencies

bool

Necessario

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

network_configuration

JobNetworkConfiguration

Necessario

Configurazione di rete per il processo.

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