Sdílet prostřednictvím

CloudJob Třída

  • Reference

Úloha Azure Batch.

Dědičnost
Model
CloudJob

Konstruktor

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)

Parametry

id
str
Vyžadováno

ID zachovává malá a velká písmena a nerozlišuje velká a malá písmena (to znamená, že v rámci účtu nemusíte mít dvě ID, která se liší pouze velikostí písmen).

display_name
str
Vyžadováno
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.

url
str
Vyžadováno
e_tag
str
Vyžadováno

Jedná se o neprůzrůzný řetězec. Můžete ho použít ke zjištění, jestli se úloha mezi jednotlivými požadavky změnila. Konkrétně můžete při aktualizaci úlohy předat eTag a určit, že se změny projeví pouze v případě, že mezitím úlohu nikdo jiný neupraví.

last_modified
datetime
Vyžadováno

Jedná se o poslední čas, kdy se data na úrovni úlohy, například stav nebo priorita úlohy, změnila. Nebere v potaz změny na úrovni úkolů, jako je přidání nových úkolů nebo změna stavu úkolů.

creation_time
datetime
Vyžadováno
state
str nebo JobState
Vyžadováno

Aktuální stav úlohy. Mezi možné hodnoty patří: "active", 'disableding', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'

state_transition_time
datetime
Vyžadováno
previous_state
str nebo JobState
Vyžadováno

Předchozí stav úlohy. Tato vlastnost není nastavena, pokud je úloha v počátečním stavu Aktivní. Mezi možné hodnoty patří: "active", 'disableding', 'disabled', 'enabling', 'terminating', 'completed', 'deleting'

previous_state_transition_time
datetime
Vyžadováno

Tato vlastnost není nastavena, pokud je úloha v počátečním stavu Aktivní.

priority
int
Vyžadováno

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1000, přičemž -1000 je nejnižší prioritou a 1000 nejvyšší prioritou. Výchozí hodnota je 0.

allow_task_preemption
bool
Vyžadováno

Určuje, zda mohou být úkoly v této úloze zrušeny jinými úlohami s vysokou prioritou. Pokud je hodnota nastavená na 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 úkolů, které lze pro úlohu provést paralelně. Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadaná. 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í úlohy pomocí rozhraní API úlohy aktualizace můžete aktualizovat hodnotu maxParallelTasks. Výchozí hodnota: -1 .

constraints
JobConstraints
Vyžadováno

Omezení provádění úlohy.

job_manager_task
JobManagerTask
Vyžadováno

Podrobnosti o úkolu Správce úloh, který se má spustit při spuštění úlohy.

job_preparation_task
JobPreparationTask
Vyžadováno

Úkol přípravy úlohy. Úkol přípravy úlohy je speciální úkol spuštěný na každém výpočetním uzlu před jakýmkoli jiným úkolem úlohy.

job_release_task
JobReleaseTask
Vyžadováno

Úloha uvolnění úlohy. Úloha uvolnění úlohy je speciální spuštění úlohy na konci úlohy na každém výpočetním uzlu, který spustil jakýkoli jiný úkol úlohy.

common_environment_settings
list[EnvironmentSetting]
Vyžadováno

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

pool_info
PoolInformation
Vyžadováno

Nastavení fondu přidružené k úloze.

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 v dokončeném stavu. 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ž některý úkol v úloze selže. Úloha se považuje za neúspěšnou, pokud má failureInfo. FailureInfo se nastaví, pokud se úloha 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. Mezi možné hodnoty patří: 'noAction', 'performExitOptionsJobAction'

network_configuration
JobNetworkConfiguration
Vyžadováno

Konfigurace sítě pro úlohu.

metadata
list[MetadataItem]
Vyžadováno

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

execution_info
JobExecutionInformation
Vyžadováno

Informace o spuštění úlohy.

stats
JobStatistics
Vyžadováno

Statistika využití prostředků za celou dobu životnosti úlohy Tato vlastnost je naplněna pouze v případě, že cloudová úloha byla načtena s klauzulí expand včetně atributu stats; v opačném případě je null. Statistika nemusí být okamžitě dostupná. Služba Batch pravidelně shrnuje statistiky. Typické zpoždění je přibližně 30 minut.

Metody

as_dict

Vrácení diktování, které může být JSONify pomocí json.dump.

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

Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. Aktuálně obsahuje 'type' s typem msrest a 'key' s klíčem kódovaným RestAPI. Value 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 to 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

Parsování diktování 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ácení diktování, které může být JSONify pomocí json.dump.

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

Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. Aktuálně obsahuje 'type' s typem msrest a 'key' s klíčem kódovaným RestAPI. Value 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 to 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í se dict 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 využívající strukturu RestAPI. Json ve výchozím nastavení.

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

Parsování diktování 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

A dict using RestAPI structure

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í se dict 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