TaskOperations Osztály

TaskOperations-műveletek.

Ne példányosítsa közvetlenül ezt az osztályt, hanem hozzon létre egy ügyfélpéldányt, amely létrehozza és attribútumként csatolja.

Öröklődés
builtins.object
TaskOperations

Konstruktor

TaskOperations(client, config, serializer, deserializer)

Paraméterek

client
Kötelező

Ügyfél a szolgáltatáskérésekhez.

config
Kötelező

A szolgáltatásügyfél konfigurálása.

serializer
Kötelező

Egy objektummodell szerializálója.

deserializer
Kötelező

Objektummodell-deszerializáló.

Változók

api_version

A kéréshez használandó API-verzió. Állandó érték: "2023-05-01.17.0".

Metódusok

add

Hozzáad egy tevékenységet a megadott feladathoz.

A tevékenységek maximális élettartama a befejezéstől számítva 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződik be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időben.

add_collection

Tevékenységek gyűjteményét adja hozzá a megadott feladathoz.

Vegye figyelembe, hogy minden tevékenységnek egyedi azonosítóval kell rendelkeznie. Előfordulhat, hogy a Batch szolgáltatás nem adja vissza az egyes tevékenységek eredményeit ugyanabban a sorrendben, mint amelyben a tevékenységek el lettek küldve ebben a kérelemben. Ha a kiszolgáló túllépi az időkorlátot, vagy a kapcsolat lezárul a kérés során, előfordulhat, hogy a kérés részben vagy teljesen fel lett dolgozva, vagy egyáltalán nem. Ilyen esetekben a felhasználónak újra ki kell küldenie a kérést. Vegye figyelembe, hogy a felhasználónak kell megfelelően kezelnie a kérések újbóli kiadásakor fellépő hibákat. Az újrapróbálkozások során például ugyanazokat a feladatazonosítókat kell használnia, hogy ha az előző művelet sikeres volt, az újrapróbálkozás ne hozzon létre váratlanul további feladatokat. Ha a válasz olyan feladatokat tartalmaz, amelyeket nem sikerült hozzáadni, az ügyfél újra megpróbálhatja a kérést. Az újrapróbálkozások során a leghatékonyabb, ha csak azokat a tevékenységeket adja újra újra, amelyeket nem sikerült hozzáadni, és kihagyni azokat a feladatokat, amelyeket az első próbálkozáskor sikeresen hozzáadtak. A tevékenységek maximális élettartama a befejezéstől számítva 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződik be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időpontban.

delete

Töröl egy tevékenységet a megadott feladatból.

Egy tevékenység törlésekor a számítási csomópont könyvtárában található összes fájl is törlődik (a megőrzési időtől függetlenül). Többpéldányos feladatok esetén a Tevékenység törlése művelet szinkron módon vonatkozik az elsődleges tevékenységre; Az altevékenységek és fájljaik ezután aszinkron módon törlődnek a háttérben.

get

Beolvassa a megadott tevékenységre vonatkozó információkat.

Többpéldányos feladatok esetén az olyan információk, mint az affinityId, a executionInfo és a nodeInfo, az elsődleges tevékenységre vonatkoznak. A list subtasks API használatával lekérheti az altevékenységekkel kapcsolatos információkat.

list

Felsorolja a megadott feladathoz társított összes tevékenységet.

Többpéldányos feladatok esetén az olyan információk, mint az affinityId, a executionInfo és a nodeInfo, az elsődleges tevékenységre vonatkoznak. A list subtasks API használatával lekérheti az altevékenységekkel kapcsolatos információkat.

list_subtasks

Felsorolja a megadott többpéldányos tevékenységhez társított összes altevékenységet.

Ha a tevékenység nem többpéldányos feladat, akkor ez egy üres gyűjteményt ad vissza.

reactivate

Újraaktivál egy tevékenységet, így akkor is újrafuthat, ha az újrapróbálkozási száma kimerült.

Az újraaktiválás lehetővé teszi, hogy a tevékenységek újrapróbálkozása a maximális újrapróbálkozási számig folytatódjon. A tevékenység állapota aktívra módosul. Mivel a tevékenység már nem befejezett állapotban van, az újraaktiválás után a korábbi kilépési kód- vagy hibainformációk már nem érhetők el. Minden alkalommal, amikor egy tevékenységet újraaktiválnak, az újrapróbálkozásainak száma 0-ra lesz visszaállítva. Az újraaktiválás sikertelen lesz a nem befejezett vagy korábban sikeresen befejezett feladatok esetében (0-s kilépési kóddal). Emellett sikertelen lesz, ha a feladat befejeződött (vagy leáll vagy töröl).

terminate

Leállítja a megadott feladatot.

A tevékenység leállásakor a befejezett állapotba kerül. Többpéldányos feladatok esetén a feladat megszakítása művelet szinkron módon vonatkozik az elsődleges tevékenységre; az altevékenységek ezután aszinkron módon leállnak a háttérben.

update

Frissítések a megadott tevékenység tulajdonságait.

add

Hozzáad egy tevékenységet a megadott feladathoz.

A tevékenységek maximális élettartama a befejezéstől számítva 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződik be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időben.

add(job_id, task, task_add_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

Annak a feladatnak az azonosítója, amelyhez a tevékenységet hozzá szeretné adni.

task
TaskAddParameter
Kötelező

A hozzáadni kívánt feladat.

task_add_options
TaskAddOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

Kivételek

add_collection

Tevékenységek gyűjteményét adja hozzá a megadott feladathoz.

Vegye figyelembe, hogy minden tevékenységnek egyedi azonosítóval kell rendelkeznie. Előfordulhat, hogy a Batch szolgáltatás nem adja vissza az egyes tevékenységek eredményeit ugyanabban a sorrendben, mint amelyben a tevékenységek el lettek küldve ebben a kérelemben. Ha a kiszolgáló túllépi az időkorlátot, vagy a kapcsolat lezárul a kérés során, előfordulhat, hogy a kérés részben vagy teljesen fel lett dolgozva, vagy egyáltalán nem. Ilyen esetekben a felhasználónak újra ki kell küldenie a kérést. Vegye figyelembe, hogy a felhasználónak kell megfelelően kezelnie a kérések újbóli kiadásakor fellépő hibákat. Az újrapróbálkozások során például ugyanazokat a feladatazonosítókat kell használnia, hogy ha az előző művelet sikeres volt, az újrapróbálkozás ne hozzon létre váratlanul további feladatokat. Ha a válasz olyan feladatokat tartalmaz, amelyeket nem sikerült hozzáadni, az ügyfél újra megpróbálhatja a kérést. Az újrapróbálkozások során a leghatékonyabb, ha csak azokat a tevékenységeket adja újra újra, amelyeket nem sikerült hozzáadni, és kihagyni azokat a feladatokat, amelyeket az első próbálkozáskor sikeresen hozzáadtak. A tevékenységek maximális élettartama a befejezéstől számítva 180 nap. Ha egy tevékenység a hozzáadást követő 180 napon belül nem fejeződik be, a Batch szolgáltatás leállítja, és bármilyen állapotban marad abban az időpontban.

add_collection(job_id, value, task_add_collection_options=None, custom_headers=None, raw=False, threads=0, **operation_config)

Paraméterek

job_id
str
Kötelező

Annak a feladatnak az azonosítója, amelyhez a feladatgyűjteményt hozzá szeretné adni.

value
list of TaskAddParameter
Kötelező

A hozzáadni kívánt feladatok gyűjteménye. A gyűjtemény teljes szerializált méretének 4 MB-nál kisebbnek kell lennie. Ha nagyobb, mint 4 MB (például ha minden tevékenységhez 100 erőforrásfájl vagy környezeti változó tartozik), a kérés a "RequestBodyTooLarge" kóddal hiúsul meg, és újra meg kell próbálkoznia kevesebb tevékenységgel.

task_add_collection_options
TaskAddCollectionOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

threads
int
alapértelmezett érték: 0

a tevékenységek hozzáadásakor párhuzamosan használandó szálak száma. Ha meg van adva és nagyobb, mint 0, további szálakat indít el a kérések elküldéséhez, és megvárja, amíg befejeződnek. Ellenkező esetben add_collection kéréseket egymás után küldi el a fő szálon

Válaszok

TaskAddCollectionResult vagy ClientRawResponse ha raw=true

Visszatérési típus

Kivételek

azure.batch.custom.CreateTasksErrorException

delete

Töröl egy tevékenységet a megadott feladatból.

Egy tevékenység törlésekor a számítási csomópont könyvtárában található összes fájl is törlődik (a megőrzési időtől függetlenül). Többpéldányos feladatok esetén a Tevékenység törlése művelet szinkron módon vonatkozik az elsődleges tevékenységre; Az altevékenységek és fájljaik ezután aszinkron módon törlődnek a háttérben.

delete(job_id, task_id, task_delete_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

Annak a feladatnak az azonosítója, amelyből törölni szeretné a tevékenységet.

task_id
str
Kötelező

A törölni kívánt feladat azonosítója.

task_delete_options
TaskDeleteOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

Kivételek

get

Beolvassa a megadott tevékenységre vonatkozó információkat.

Többpéldányos feladatok esetén az olyan információk, mint az affinityId, a executionInfo és a nodeInfo, az elsődleges tevékenységre vonatkoznak. A list subtasks API használatával lekérheti az altevékenységekkel kapcsolatos információkat.

get(job_id, task_id, task_get_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A tevékenységet tartalmazó feladat azonosítója.

task_id
str
Kötelező

A tevékenység azonosítója, amelyről információt szeretne kapni.

task_get_options
TaskGetOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

CloudTask vagy ClientRawResponse, ha raw=true

Visszatérési típus

Kivételek

list

Felsorolja a megadott feladathoz társított összes tevékenységet.

Többpéldányos feladatok esetén az olyan információk, mint az affinityId, a executionInfo és a nodeInfo, az elsődleges tevékenységre vonatkoznak. A list subtasks API használatával lekérheti az altevékenységekkel kapcsolatos információkat.

list(job_id, task_list_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A feladat azonosítója.

task_list_options
TaskListOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Iterátor, például a CloudTask példánya

Visszatérési típus

Kivételek

list_subtasks

Felsorolja a megadott többpéldányos tevékenységhez társított összes altevékenységet.

Ha a tevékenység nem többpéldányos feladat, akkor ez egy üres gyűjteményt ad vissza.

list_subtasks(job_id, task_id, task_list_subtasks_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A feladat azonosítója.

task_id
str
Kötelező

A tevékenység azonosítója.

task_list_subtasks_options
TaskListSubtasksOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

CloudTaskListSubtasksResult vagy ClientRawResponse, ha raw=true

Visszatérési típus

Kivételek

reactivate

Újraaktivál egy tevékenységet, így akkor is újrafuthat, ha az újrapróbálkozási száma kimerült.

Az újraaktiválás lehetővé teszi, hogy a tevékenységek újrapróbálkozása a maximális újrapróbálkozási számig folytatódjon. A tevékenység állapota aktívra módosul. Mivel a tevékenység már nem befejezett állapotban van, az újraaktiválás után a korábbi kilépési kód- vagy hibainformációk már nem érhetők el. Minden alkalommal, amikor egy tevékenységet újraaktiválnak, az újrapróbálkozásainak száma 0-ra lesz visszaállítva. Az újraaktiválás sikertelen lesz a nem befejezett vagy korábban sikeresen befejezett feladatok esetében (0-s kilépési kóddal). Emellett sikertelen lesz, ha a feladat befejeződött (vagy leáll vagy töröl).

reactivate(job_id, task_id, task_reactivate_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A tevékenységet tartalmazó feladat azonosítója.

task_id
str
Kötelező

Az újraaktiválni kívánt tevékenység azonosítója.

task_reactivate_options
TaskReactivateOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

Kivételek

terminate

Leállítja a megadott feladatot.

A tevékenység leállásakor a befejezett állapotba kerül. Többpéldányos feladatok esetén a feladat megszakítása művelet szinkron módon vonatkozik az elsődleges tevékenységre; az altevékenységek ezután aszinkron módon leállnak a háttérben.

terminate(job_id, task_id, task_terminate_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A tevékenységet tartalmazó feladat azonosítója.

task_id
str
Kötelező

A leállítandó feladat azonosítója.

task_terminate_options
TaskTerminateOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

Kivételek

update

Frissítések a megadott tevékenység tulajdonságait.

update(job_id, task_id, constraints=None, task_update_options=None, custom_headers=None, raw=False, **operation_config)

Paraméterek

job_id
str
Kötelező

A tevékenységet tartalmazó feladat azonosítója.

task_id
str
Kötelező

A frissíteni kívánt feladat azonosítója.

constraints
TaskConstraints
alapértelmezett érték: None

A tevékenységre vonatkozó korlátozások. Ha nincs megadva, a tevékenységhez az alapértelmezett korlátozások lesznek megadva. Többpéldányos feladatok esetén a megőrzési idő frissítése csak az elsődleges tevékenységre vonatkozik, altevékenységekre nem.

task_update_options
TaskUpdateOptions
alapértelmezett érték: None

A művelet további paraméterei

custom_headers
dict
alapértelmezett érték: None

a kérelemhez hozzáadandó fejlécek

raw
bool
alapértelmezett érték: False

a deszerializált válasz mellett a közvetlen választ adja vissza

operation_config
Kötelező

Műveleti konfiguráció felülbírálásai.

Válaszok

Nincs vagy ClientRawResponse, ha raw=true

Visszatérési típus

None,

Kivételek

Attribútumok

models

models = <module 'azure.batch.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\batch\\models\\__init__.py'>