JobAddParameter Osztály
Hozzáadandó Azure Batch feladat.
Az Azure-ba való küldéshez minden szükséges paramétert fel kell tölteni.
- Öröklődés
-
JobAddParameter
Konstruktor
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)Paraméterek
- id
- str
Kötelező. Az azonosító tartalmazhat alfanumerikus karakterek bármilyen kombinációját, beleértve a kötőjeleket és az aláhúzásjeleket, és legfeljebb 64 karaktert tartalmazhat. Az azonosító kis- és nagybetűket nem különböztet meg (vagyis előfordulhat, hogy nem rendelkezik két azonosítóval egy fiókon belül, amelyek csak esetenként különböznek).
- display_name
- str
A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 karakter hosszúságú Unicode-karaktereket tartalmazhat.
- priority
- int
A feladat prioritása. A prioritási értékek -1000 és 1000 között lehetnek, a -1000 a legalacsonyabb prioritás, az 1000 pedig a legmagasabb prioritás. Az alapértelmezett érték a 0.
- max_parallel_tasks
- int
A feladathoz párhuzamosan végrehajtható tevékenységek maximális száma. A maxParallelTasks értékének -1-nek vagy 0-nál nagyobbnak kell lennie, ha meg van adva. Ha nincs megadva, az alapértelmezett érték -1, ami azt jelenti, hogy nincs korlátozva az egyszerre futtatható tevékenységek száma. A feladat maxParallelTasks értékeit a feladat API-val való létrehozása után frissítheti. Alapértelmezett érték: -1 .
- allow_task_preemption
- bool
Azt határozza meg, hogy a feladat tevékenységeit más magas prioritású feladatok elő tudják-e előtagként kezelni. Ha az érték True (Igaz) értékre van állítva, a rendszernek elküldött egyéb magas prioritású feladatok elsőbbséget élveznek, és újra lekérdezhetik a feladat tevékenységeit. A feladat allowTaskPreemption elemét a feladat API-val való létrehozása után frissítheti.
- job_manager_task
- JobManagerTask
A feladat indításakor elindítandó feladatkezelői tevékenység részletei. Ha a feladat nem ad meg feladatkezelői feladatot, a felhasználónak explicit módon hozzá kell adnia a Feladathoz a Tevékenységeket. Ha a feladat nem ad meg feladatkezelői tevékenységet, a Batch szolgáltatás a feladat létrehozásakor létrehozza a Feladatkezelő tevékenységet, és a feladat többi tevékenységének ütemezése előtt megpróbálja ütemezni a Feladatkezelő tevékenységet. A Feladatkezelői tevékenység jellemző célja a feladatok végrehajtásának szabályozása és/vagy monitorozása, például a futtatandó további feladatok eldöntésével, a munka befejezésének megállapításával stb. (A Feladatkezelő tevékenység azonban nem korlátozódik ezekre a tevékenységekre – ez egy teljes értékű feladat a rendszerben, és a feladathoz szükséges műveleteket hajtja végre.) Egy Feladatkezelő-feladat például letölthet egy paraméterként megadott fájlt, elemezheti a fájl tartalmát, és további feladatokat küldhet be ezek alapján.
- job_preparation_task
- JobPreparationTask
A feladat-előkészítési feladat. Ha egy feladathoz feladat-előkészítési tevékenység tartozik, a Batch szolgáltatás futtatja a feladat-előkészítési feladatot egy csomóponton, mielőtt elindítja a feladat tevékenységeit az adott számítási csomóponton.
- job_release_task
- JobReleaseTask
A feladatkiadási feladat. Feladatkiadási tevékenység nem adható meg anélkül, hogy a feladathoz feladat-előkészítési feladatot is meg kellene adnia. A Batch szolgáltatás a feladat-előkészítési feladatot futtató csomópontokon futtatja a feladatkiadási feladatot. A feladatkiadási tevékenység elsődleges célja a feladat-előkészítési tevékenység által végrehajtott számítási csomópontok módosításainak visszavonása. A példatevékenységek közé tartozik a helyi fájlok törlése vagy a feladat-előkészítés részeként elindított szolgáltatások leállítása.
- common_environment_settings
- list[EnvironmentSetting]
Az egyes feladatok felülbírálhatják az itt megadott környezeti beállításokat ugyanazzal a beállításnévvel, egy másik értékkel.
- pool_info
- PoolInformation
Kötelező. Az a készlet, amelyen a Batch szolgáltatás futtatja a feladat feladatait.
- on_all_tasks_complete
- str vagy OnAllTasksComplete
A Batch szolgáltatásnak el kell végeznie a műveletet, amikor a feladat összes tevékenysége befejezett állapotban van. Vegye figyelembe, hogy ha egy feladat nem tartalmaz tevékenységeket, akkor a rendszer minden tevékenységet befejezettnek tekint. Ezt a lehetőséget ezért leggyakrabban feladatkezelői feladatokkal használják; Ha automatikus feladatleállást szeretne használni feladatkezelő nélkül, először aAllTasksComplete beállítást noaction értékre kell állítania, majd frissítenie kell a feladattulajdonságokat úgy, hogy aAllTasksComplete értékre állítsa a feladat leállítását, miután befejezte a tevékenységek hozzáadását. Az alapértelmezett érték a noaction. Lehetséges értékek: "noAction", "terminateJob"
- on_task_failure
- str vagy OnTaskFailure
A Batch szolgáltatásnak el kell végeznie a műveletet, ha a feladat bármely tevékenysége meghiúsul. Egy feladat meghiúsultnak minősül, ha hibásInfo. A failureInfo akkor van beállítva, ha a tevékenység nem nulla kilépési kóddal fejeződik be az újrapróbálkozások számának kimerítése után, vagy ha hiba történt a tevékenység indításakor, például egy erőforrásfájl letöltési hibája miatt. Az alapértelmezett érték a noaction. Lehetséges értékek: "noAction", "performExitOptionsJobAction"
- metadata
- list[MetadataItem]
A Batch szolgáltatás nem rendel semmilyen jelentést a metaadatokhoz; kizárólag felhasználói kód használatára használható.
- uses_task_dependencies
- bool
Azt határozza meg, hogy a feladat tevékenységei definiálhatnak-e függőségeket egymástól. Az alapértelmezett érték hamis.
Metódusok
| as_dict |
Adjon vissza egy JSONify típusú diktáltot a json.dump használatával. A speciális használat opcionálisan visszahívást is használhat paraméterként: A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke. A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti. Tekintse meg a fájl három példáját:
Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket. |
| deserialize |
Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt. |
| enable_additional_properties_sending | |
| from_dict |
A diktálás adott kulcselszívóval történő elemzése modell visszaadása. Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor) |
| is_xml_model | |
| serialize |
A modellből az Azure-ba küldendő JSON-t adja vissza. Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias. Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket. |
| validate |
Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját. |
as_dict
Adjon vissza egy JSONify típusú diktáltot a json.dump használatával.
A speciális használat opcionálisan visszahívást is használhat paraméterként:
A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke.
A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti.
Tekintse meg a fájl három példáját:
attribute_transformer
full_restapi_key_transformer
last_restapi_key_transformer
Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.
as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)Paraméterek
- key_transformer
- <xref:function>
Egy kulcsátalakító függvény.
- keep_readonly
Válaszok
A dict JSON-kompatibilis objektum
Visszatérési típus
deserialize
Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.
deserialize(data, content_type=None)Paraméterek
- content_type
- str
A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.
Válaszok
A modell egy példánya
Kivételek
enable_additional_properties_sending
enable_additional_properties_sending()from_dict
A diktálás adott kulcselszívóval történő elemzése modell visszaadása.
Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor)
from_dict(data, key_extractors=None, content_type=None)Paraméterek
- content_type
- str
A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.
- key_extractors
Válaszok
A modell egy példánya
Kivételek
is_xml_model
is_xml_model()serialize
A modellből az Azure-ba küldendő JSON-t adja vissza.
Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias.
Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.
serialize(keep_readonly=False, **kwargs)Paraméterek
- keep_readonly
- bool
Ha szerializálni szeretné az olvasható attribútumokat
Válaszok
A dict JSON-kompatibilis objektum
Visszatérési típus
validate
Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját.
validate()Válaszok
Az érvényesítési hiba listája
Visszatérési típus
Azure SDK for Python
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: