Sdílet prostřednictvím

JobSpecification Třída

  • Reference

Určuje podrobnosti o úlohách, které se mají vytvořit podle plánu.

Aby bylo možné odesílat do Azure, musí být vyplněny všechny požadované parametry.

Dědičnost
Model
JobSpecification

Konstruktor

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

Parametry

priority
int
Vyžadováno

Priorita úloh vytvořených podle tohoto plánu Hodnoty priority můžou být v rozsahu od -1000 do 1000, přičemž -1000 je nejnižší priorita a 1000 nejvyšší priorita. Výchozí hodnota je 0. Tato priorita se používá jako výchozí pro všechny úlohy v rámci plánu úloh. Prioritu úlohy po jejím vytvoření můžete aktualizovat pomocí rozhraní API úlohy aktualizace.

allow_task_preemption
bool
Vyžadováno

Určuje, jestli mohou být úkoly v této úloze preemptovány jinými úlohami s vysokou prioritou. Pokud je hodnota nastavená na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moct z této úlohy znovu vytvořit frontu úkolů. Úlohu allowTaskPreemption můžete po vytvoření aktualizovat pomocí rozhraní API úlohy aktualizace.

max_parallel_tasks
int
Vyžadováno

Maximální počet úloh, které lze pro úlohu provádět paralelně. Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadaný, výchozí hodnota je -1, což znamená, že počet úloh, které je možné spustit najednou, není nijak omezený. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace. Výchozí hodnota: -1 .

display_name
str
Vyžadováno

Název nemusí být jedinečný a může obsahovat znaky Unicode až do maximální délky 1024.

uses_task_dependencies
bool
Vyžadováno

Určuje, jestli úkoly v úloze můžou definovat vzájemné závislosti. Výchozí hodnotou je hodnota false.

on_all_tasks_complete
str nebo OnAllTasksComplete
Vyžadováno

Akce, kterou by služba Batch měla provést, když jsou všechny úkoly v úloze vytvořené podle tohoto plánu v dokončeném stavu. Všimněte si, že pokud úloha neobsahuje žádné úkoly, považují se všechny úkoly za dokončené. Tato možnost se proto nejčastěji používá s úlohou Správce úloh; Pokud chcete použít automatické ukončení úlohy bez Správce úloh, měli byste nejprve nastavit naAllTasksComplete na noaction a aktualizovat vlastnosti úlohy tak, aby nastavte naAllTasksComplete na terminatejob, jakmile dokončíte přidávání úkolů. Výchozí hodnota je noaction. Mezi možné hodnoty patří: 'noAction', 'terminateJob'

on_task_failure
str nebo OnTaskFailure
Vyžadováno

Akce, kterou by služba Batch měla provést, když dojde k selhání úlohy v úloze vytvořené podle tohoto plánu. Úloha se považuje za neúspěšnou, pokud selhala, pokud má informace o selhání. FailureInfo se nastaví, pokud se úkol dokončí s nenulovým ukončovacím kódem po vyčerpání počtu opakování nebo pokud došlo k chybě při spuštění úlohy, například kvůli chybě při stahování souboru zdroje. Výchozí hodnota je noaction. Možné hodnoty: 'noAction', 'performExitOptionsJobAction'

network_configuration
JobNetworkConfiguration
Vyžadováno

Konfigurace sítě pro úlohu

constraints
JobConstraints
Vyžadováno

Omezení spouštění pro úlohy vytvořené v rámci tohoto plánu

job_manager_task
JobManagerTask
Vyžadováno

Podrobnosti úlohy Správce úloh, která se má spustit při spuštění úlohy podle tohoto plánu. Pokud úloha neurčila úlohu Správce úloh, musí uživatel explicitně přidat úkoly do úlohy pomocí rozhraní TASK API. Pokud úloha určuje úlohu Správce úloh, služba Batch vytvoří při vytvoření úlohy úlohu Správce úloh a pokusí se naplánovat úlohu Správce úloh před plánováním dalších úkolů v úloze.

job_preparation_task
JobPreparationTask
Vyžadováno

Úloha přípravy úlohy pro úlohy vytvořené podle tohoto plánu Pokud má úloha úlohu přípravy úlohy, služba Batch spustí úlohu přípravy úlohy na uzlu před spuštěním libovolné úlohy v daném výpočetním uzlu.

job_release_task
JobReleaseTask
Vyžadováno

Úloha uvolnění úlohy pro úlohy vytvořené podle tohoto plánu Primárním účelem úlohy uvolnění úlohy je vrátit zpět změny uzlů provedené úlohou přípravy úlohy. Mezi příklady aktivit patří odstranění místních souborů nebo vypnutí služeb, které byly spuštěny v rámci přípravy úlohy. Úkol uvolnění úlohy nelze zadat, aniž byste také zadali úkol přípravy úlohy pro tuto úlohu. Služba Batch spustí úlohu vydání úlohy na výpočetních uzlech, na kterých byla spuštěna úloha přípravy úlohy.

common_environment_settings
list[EnvironmentSetting]
Vyžadováno

Jednotlivé úlohy můžou přepsat nastavení prostředí zadané tady zadáním stejného názvu nastavení s jinou hodnotou.

pool_info
PoolInformation
Vyžadováno

Povinná hodnota. Fond, ve kterém služba Batch spouští úlohy vytvořené podle tohoto plánu.

metadata
list[MetadataItem]
Vyžadováno

Služba Batch nepřiřazuje metadatům žádný význam. je určen výhradně pro použití uživatelského kódu.

Metody

as_dict

Vrátí dikt, který může být JSONify pomocí json.dump.

Rozšířené využití může volitelně použít zpětné volání jako parametr:

Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. V současné době obsahuje "type" s typem msrest a "key" s klíčem kódovaným restAPI. Hodnota je aktuální hodnota v tomto objektu.

Vrácený řetězec se použije k serializaci klíče. Pokud je návratovým typem seznam, považuje se za hierarchický dikt výsledku.

Podívejte se na tři příklady v tomto souboru:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.
deserialize

Parsujte str pomocí syntaxe RestAPI a vraťte model.
enable_additional_properties_sending
from_dict

Analýza diktu pomocí daného extraktoru klíčů vrátí model.

Ve výchozím nastavení zvažte extraktory klíčů (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor a last_rest_key_case_insensitive_extractor).
is_xml_model
serialize

Vrátí kód JSON, který se z tohoto modelu odešle do Azure.

Toto je alias pro as_dict(full_restapi_key_transformer; keep_readonly=False).

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.
validate

Rekurzivně ověřte tento model a vraťte seznam ValidationError.

as_dict

Vrátí dikt, který může být JSONify pomocí json.dump.

Rozšířené využití může volitelně použít zpětné volání jako parametr:

Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. V současné době obsahuje "type" s typem msrest a "key" s klíčem kódovaným restAPI. Hodnota je aktuální hodnota v tomto objektu.

Vrácený řetězec se použije k serializaci klíče. Pokud je návratovým typem seznam, považuje se za hierarchický dikt výsledku.

Podívejte se na tři příklady v tomto souboru:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.

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

Parametry

key_transformer
<xref:function>

Funkce klíčového transformátoru.

keep_readonly
výchozí hodnota: True

Návraty

Objekt kompatibilní s diktem JSON

Návratový typ

dict

deserialize

Parsujte str pomocí syntaxe RestAPI a vraťte model.

deserialize(data, content_type=None)

Parametry

data
str
Vyžadováno

Str používající strukturu RestAPI. Ve výchozím nastavení JSON.

content_type
str
výchozí hodnota: None

Ve výchozím nastavení JSON nastavte application/xml, pokud XML.

Návraty

Instance tohoto modelu

Výjimky

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

Analýza diktu pomocí daného extraktoru klíčů vrátí model.

Ve výchozím nastavení zvažte extraktory klíčů (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor a last_rest_key_case_insensitive_extractor).

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

Parametry

data
dict
Vyžadováno

Diktování pomocí struktury RestAPI

content_type
str
výchozí hodnota: None

Ve výchozím nastavení JSON nastavte application/xml, pokud XML.

key_extractors
výchozí hodnota: None

Návraty

Instance tohoto modelu

Výjimky

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

Vrátí kód JSON, který se z tohoto modelu odešle do Azure.

Toto je alias pro as_dict(full_restapi_key_transformer; keep_readonly=False).

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametry

keep_readonly
bool
výchozí hodnota: False

Pokud chcete serializovat atributy readonly

Návraty

Objekt kompatibilní s diktem JSON

Návratový typ

dict

validate

Rekurzivně ověřte tento model a vraťte seznam ValidationError.

validate()

Návraty

Seznam chyb ověření

Návratový typ

list