TaskOperations Třída
Operace TaskOperations.
Neměli byste vytvořit instanci přímo této třídy, ale vytvořit instanci klienta, která ji vytvoří pro vás a připojí ji jako atribut.
- Dědičnost
-
builtins.objectTaskOperations
Konstruktor
TaskOperations(client, config, serializer, deserializer)
Parametry
- client
Klient pro žádosti o služby.
- config
Konfigurace klienta služby.
- serializer
Serializátor objektového modelu.
- deserializer
Deserializátor objektového modelu.
Proměnné
- api_version
Verze rozhraní API, která se má použít pro požadavek. Konstantní hodnota: "2023-05-01.17.0".
Metody
add |
Přidá úkol do zadané úlohy. Maximální životnost úkolu od přidání do dokončení je 180 dnů. Pokud se úkol nedokončil do 180 dnů od přidání, služba Batch ho ukončí a ponechá v jakémkoli stavu, v jakém byl v té době. |
add_collection |
Přidá kolekci úkolů do zadané úlohy. Všimněte si, že každý úkol musí mít jedinečné ID. Služba Batch nemusí vrátit výsledky pro každý úkol ve stejném pořadí, v jakém byly úkoly odeslány v tomto požadavku. Pokud dojde k vypršení časového limitu serveru nebo k ukončení připojení během požadavku, je možné, že požadavek byl částečně nebo zcela zpracován nebo vůbec. V takových případech by uživatel měl žádost vydat znovu. Všimněte si, že je na uživateli, aby správně zvládl selhání při opětovném vystavení požadavku. Při opakování byste například měli použít stejná ID úloh, aby se v případě úspěchu předchozí operace neočekávaně nevytvořily další úkoly. Pokud odpověď obsahuje nějaké úkoly, které se nepodařilo přidat, může klient zkusit požadavek zopakovat. Při opakování je nejúčinnější znovu odeslat pouze úkoly, které se nepodařilo přidat, a vynechat úkoly, které byly úspěšně přidány při prvním pokusu. Maximální životnost úkolu od přidání do dokončení je 180 dnů. Pokud se úkol nedokončil do 180 dnů od přidání, služba Batch ho ukončí a ponechá v jakémkoli stavu, v jakém byl v té době. |
delete |
Odstraní úkol ze zadané úlohy. Při odstranění úlohy se odstraní také všechny soubory v jejím adresáři na výpočetním uzlu, na kterém byla úloha spuštěna (bez ohledu na dobu uchovávání). U úkolů s více instancemi se operace odstranění úlohy použije synchronně na primární úkol. dílčí úkoly a jejich soubory se pak asynchronně odstraňují na pozadí. |
get |
Získá informace o zadaném úkolu. Informace o úlohách s více instancemi, jako jsou affinityId, executionInfo a nodeInfo, odkazují na primární úlohu. K načtení informací o dílčích úkolůch použijte rozhraní API seznamu dílčích úkolů. |
list |
Zobrazí seznam všech úkolů přidružených k zadané úloze. Informace o úlohách s více instancemi, jako jsou affinityId, executionInfo a nodeInfo, odkazují na primární úlohu. K načtení informací o dílčích úkolůch použijte rozhraní API seznamu dílčích úkolů. |
list_subtasks |
Zobrazí seznam všech dílčích úkolů přidružených k zadané úloze s více instancemi. Pokud úloha není úlohou s více instancemi, vrátí se prázdná kolekce. |
reactivate |
Znovu aktivuje úlohu a umožní její opětovné spuštění, i když byl počet opakování vyčerpán. Opětovná aktivace způsobí, že úkol může být znovu zkoušený až do maximálního počtu opakování. Stav úkolu se změní na aktivní. Vzhledem k tomu, že úloha již není ve stavu dokončení, nebudou po opětovné aktivaci k dispozici žádné předchozí ukončovací kódy nebo informace o selhání. Při každé opětovné aktivaci úkolu se počet opakování resetuje na 0. Opětovná aktivace se nezdaří u úkolů, které nebyly dokončeny nebo které byly dříve úspěšně dokončeny (s ukončovacím kódem 0). Kromě toho selže, pokud se úloha dokončila (nebo ukončuje nebo odstraňuje). |
terminate |
Ukončí zadaný úkol. Po ukončení se úkol přesune do dokončeného stavu. U úloh s více instancemi se operace ukončení úlohy použije synchronně na primární úlohu; Dílčí úkoly se pak asynchronně ukončují na pozadí. |
update |
Aktualizace vlastnosti zadané úlohy. |
add
Přidá úkol do zadané úlohy.
Maximální životnost úkolu od přidání do dokončení je 180 dnů. Pokud se úkol nedokončil do 180 dnů od přidání, služba Batch ho ukončí a ponechá v jakémkoli stavu, v jakém byl v té době.
add(job_id, task, task_add_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
None nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
add_collection
Přidá kolekci úkolů do zadané úlohy.
Všimněte si, že každý úkol musí mít jedinečné ID. Služba Batch nemusí vrátit výsledky pro každý úkol ve stejném pořadí, v jakém byly úkoly odeslány v tomto požadavku. Pokud dojde k vypršení časového limitu serveru nebo k ukončení připojení během požadavku, je možné, že požadavek byl částečně nebo zcela zpracován nebo vůbec. V takových případech by uživatel měl žádost vydat znovu. Všimněte si, že je na uživateli, aby správně zvládl selhání při opětovném vystavení požadavku. Při opakování byste například měli použít stejná ID úloh, aby se v případě úspěchu předchozí operace neočekávaně nevytvořily další úkoly. Pokud odpověď obsahuje nějaké úkoly, které se nepodařilo přidat, může klient zkusit požadavek zopakovat. Při opakování je nejúčinnější znovu odeslat pouze úkoly, které se nepodařilo přidat, a vynechat úkoly, které byly úspěšně přidány při prvním pokusu. Maximální životnost úkolu od přidání do dokončení je 180 dnů. Pokud se úkol nedokončil do 180 dnů od přidání, služba Batch ho ukončí a ponechá v jakémkoli stavu, v jakém byl v té době.
add_collection(job_id, value, task_add_collection_options=None, custom_headers=None, raw=False, threads=0, **operation_config)
Parametry
- value
- list of TaskAddParameter
Kolekce úkolů, které chcete přidat. Celková serializovaná velikost této kolekce musí být menší než 4 MB. Pokud je větší než 4 MB (například pokud má každý úkol 100 souborů prostředků nebo proměnných prostředí), požadavek selže s kódem RequestBodyTooLarge a měl by se opakovat s menším počtem úkolů.
- task_add_collection_options
- TaskAddCollectionOptions
Další parametry pro operaci
- threads
- int
počet vláken, která se mají použít paralelně při přidávání úkolů. Pokud je zadaný a větší než 0, spustí další vlákna pro odesílání požadavků a počká na jejich dokončení. Jinak budou požadavky add_collection odesílat postupně v hlavním vlákně.
Návraty
TaskAddCollectionResult nebo ClientRawResponse pokud raw=true
Návratový typ
Výjimky
delete
Odstraní úkol ze zadané úlohy.
Při odstranění úlohy se odstraní také všechny soubory v jejím adresáři na výpočetním uzlu, na kterém byla úloha spuštěna (bez ohledu na dobu uchovávání). U úkolů s více instancemi se operace odstranění úlohy použije synchronně na primární úkol. dílčí úkoly a jejich soubory se pak asynchronně odstraňují na pozadí.
delete(job_id, task_id, task_delete_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
None nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
get
Získá informace o zadaném úkolu.
Informace o úlohách s více instancemi, jako jsou affinityId, executionInfo a nodeInfo, odkazují na primární úlohu. K načtení informací o dílčích úkolůch použijte rozhraní API seznamu dílčích úkolů.
get(job_id, task_id, task_get_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
CloudTask nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
list
Zobrazí seznam všech úkolů přidružených k zadané úloze.
Informace o úlohách s více instancemi, jako jsou affinityId, executionInfo a nodeInfo, odkazují na primární úlohu. K načtení informací o dílčích úkolůch použijte rozhraní API seznamu dílčích úkolů.
list(job_id, task_list_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
Iterátor, jako je instance CloudTask
Návratový typ
Výjimky
list_subtasks
Zobrazí seznam všech dílčích úkolů přidružených k zadané úloze s více instancemi.
Pokud úloha není úlohou s více instancemi, vrátí se prázdná kolekce.
list_subtasks(job_id, task_id, task_list_subtasks_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- task_list_subtasks_options
- TaskListSubtasksOptions
Další parametry pro operaci
- operation_config
Přepsání konfigurace operace
Návraty
CloudTaskListSubtasksResult nebo ClientRawResponse, pokud raw=true
Návratový typ
Výjimky
reactivate
Znovu aktivuje úlohu a umožní její opětovné spuštění, i když byl počet opakování vyčerpán.
Opětovná aktivace způsobí, že úkol může být znovu zkoušený až do maximálního počtu opakování. Stav úkolu se změní na aktivní. Vzhledem k tomu, že úloha již není ve stavu dokončení, nebudou po opětovné aktivaci k dispozici žádné předchozí ukončovací kódy nebo informace o selhání. Při každé opětovné aktivaci úkolu se počet opakování resetuje na 0. Opětovná aktivace se nezdaří u úkolů, které nebyly dokončeny nebo které byly dříve úspěšně dokončeny (s ukončovacím kódem 0). Kromě toho selže, pokud se úloha dokončila (nebo ukončuje nebo odstraňuje).
reactivate(job_id, task_id, task_reactivate_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
None nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
terminate
Ukončí zadaný úkol.
Po ukončení se úkol přesune do dokončeného stavu. U úloh s více instancemi se operace ukončení úlohy použije synchronně na primární úlohu; Dílčí úkoly se pak asynchronně ukončují na pozadí.
terminate(job_id, task_id, task_terminate_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- operation_config
Přepsání konfigurace operace
Návraty
None nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
update
Aktualizace vlastnosti zadané úlohy.
update(job_id, task_id, constraints=None, task_update_options=None, custom_headers=None, raw=False, **operation_config)
Parametry
- constraints
- TaskConstraints
Omezení, která se vztahují na tento úkol. Pokud ho vynecháte, bude úkol nastaven na výchozí omezení. U úloh s více instancemi se aktualizace doby uchovávání vztahuje pouze na primární úlohu, a ne na dílčí úkoly.
- operation_config
Přepsání konfigurace operace
Návraty
None nebo ClientRawResponse if raw=true
Návratový typ
Výjimky
Atributy
models
models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>
Azure SDK for Python