TaskAddParameter Osztály
Hozzáadandó Azure Batch feladat.
A Batch újra megkísérli a Feladatokat, amikor egy helyreállítási művelet aktiválódik egy csomóponton. A helyreállítási műveletek közé tartoznak például (de nem kizárólagosan), ha egy nem kifogástalan állapotú csomópont újraindul, vagy egy számítási csomópont a gazdagép hibája miatt eltűnt. A helyreállítási műveletek miatti újrapróbálkozások függetlenek a függvényétől, és nem számítanak bele a maxTaskRetryCount értékbe. Még ha a maxTaskRetryCount is 0, egy helyreállítási művelet miatt belső újrapróbálkozhat. Emiatt minden tevékenységnek idempotensnek kell lennie. Ez azt jelenti, hogy a feladatoknak el kell viselnie a megszakítást és az újraindítást anélkül, hogy sérülést vagy duplikált adatokat okoznak. A hosszú ideig futó feladatok ajánlott eljárása az ellenőrzőpontok valamilyen formájának használata.
Az Azure-ba való küldéshez minden szükséges paramétert fel kell tölteni.
- Öröklődés
-
TaskAddParameter
Konstruktor
TaskAddParameter(*, id: str, command_line: str, display_name: str = None, container_settings=None, exit_conditions=None, resource_files=None, output_files=None, environment_settings=None, affinity_info=None, constraints=None, required_slots: int = None, user_identity=None, multi_instance_settings=None, depends_on=None, application_package_references=None, authentication_token_settings=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 feladaton 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.
- command_line
- str
Kötelező. Többpéldányos feladatok esetén a parancssor elsődleges feladatként lesz végrehajtva, miután az elsődleges tevékenység és az összes altevékenység befejezte a koordinációs parancssor végrehajtását. A parancssor nem rendszerhéj alatt fut, ezért nem tudja kihasználni a rendszerhéj olyan funkcióit, mint a környezeti változók bővítése. Ha ki szeretné használni az ilyen funkciókat, hívja meg a rendszerhéjat a parancssorban, például a windowsos "cmd /c MyCommand" vagy a "/bin/sh -c MyCommand" parancsmagot Linuxon. Ha a parancssor fájlelérési utakra hivatkozik, relatív elérési utat kell használnia (a Tevékenység munkakönyvtárhoz viszonyítva), vagy a Batch által megadott környezeti változót (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
- container_settings
- TaskContainerSettings
Annak a tárolónak a beállításai, amelyek alatt a feladat fut. Ha a feladatot futtató készlet tárolókonfigurálási készlettel rendelkezik, ezt is be kell állítani. Ha a feladatot futtató készlet nem rendelkezik tárolókOnfigurálás beállításával, ezt nem szabad beállítani. Ha ez a beállítás meg van adva, a AZ_BATCH_NODE_ROOT_DIR alatti összes címtár (a csomóponton Azure Batch könyvtárak gyökere) a tárolóba lesz leképezve, az összes tevékenységkörnyezeti változó a tárolóba lesz leképezve, a Feladat parancssor pedig a tárolóban lesz végrehajtva. Előfordulhat, hogy a tárolóban a AZ_BATCH_NODE_ROOT_DIR kívül létrehozott fájlok nem jelennek meg a gazdalemezen, ami azt jelenti, hogy a Batch-fájl API-k nem fogják tudni elérni ezeket a fájlokat.
- exit_conditions
- ExitConditions
Hogyan reagáljon a Batch szolgáltatás a feladat befejezésekor?
- resource_files
- list[ResourceFile]
Többpéldányos feladatok esetén az erőforrásfájlok csak arra a számítási csomópontra lesznek letöltve, amelyen az elsődleges tevékenység végrehajtása történik. Az erőforrásfájlok listájának maximális mérete van. Ha túllépi a maximális méretet, a kérés sikertelen lesz, és a válasz hibakódja RequestEntityTooLarge lesz. Ha ez történik, a ResourceFiles gyűjteményét méretben kell csökkenteni. Ez .zip fájlok, alkalmazáscsomagok vagy Docker-tárolók használatával érhető el.
- output_files
- list[OutputFile]
Többpéldányos feladatok esetén a fájlok csak abból a számítási csomópontból lesznek feltöltve, amelyen az elsődleges tevékenység végrehajtása történik.
- environment_settings
- list[EnvironmentSetting]
- affinity_info
- AffinityInformation
A Batch szolgáltatás által egy olyan számítási csomópont kiválasztására használható helymutató, amelyen az új feladatot el szeretné indítani.
- constraints
- TaskConstraints
A tevékenységre vonatkozó végrehajtási korlátozások. Ha nem ad meg korlátozásokat, a maxTaskRetryCount a feladathoz megadott maxTaskRetryCount, a maxWallClockTime végtelen, a retentionTime pedig 7 nap.
- required_slots
- int
Az ütemezési pontok száma, amelyeket a feladatnak futtatnia kell. Az alapértelmezett érték 1. Egy tevékenység csak akkor ütemezhető úgy, hogy egy számítási csomóponton fusson, ha a csomópont elegendő szabad ütemezési hellyel rendelkezik. Többpéldányos feladatok esetén ennek 1-nek kell lennie.
- user_identity
- UserIdentity
A felhasználói identitás, amely alatt a feladat fut. Ha nincs megadva, a tevékenység a tevékenységre egyedi, nem rendszergazdai felhasználóként fut.
- multi_instance_settings
- MultiInstanceSettings
Egy objektum, amely azt jelzi, hogy a tevékenység többpéldányos feladat, és információt tartalmaz a többpéldányos feladat futtatásáról.
- depends_on
- TaskDependencies
Azok a tevékenységek, amelyektől ez a tevékenység függ. Ez a tevékenység csak akkor lesz ütemezve, ha az összes olyan tevékenység sikeresen befejeződött, amelytől függ. Ha bármelyik tevékenység sikertelen, és kimeríti az újrapróbálkozások számát, ez a tevékenység soha nem lesz ütemezve. Ha a feladat nem rendelkezik true (igaz) értékre állított UsesTaskDependencies értékekkel, és ez az elem jelen van, a kérés a TaskDependenciesNotSpecifiedOnJob hibakóddal hiúsul meg.
- application_package_references
- list[ApplicationPackageReference]
Az alkalmazáscsomagokat a rendszer egy megosztott könyvtárba tölti le és helyezi üzembe, nem pedig a Feladat munkakönyvtárba. Ezért ha egy hivatkozott csomag már megtalálható a Csomóponton, és naprakész, akkor nem tölti le újra; A rendszer a számítási csomópont meglévő példányát használja. Ha egy hivatkozott csomag nem telepíthető, például a csomag törlése vagy a letöltés sikertelensége miatt, a feladat meghiúsul.
- authentication_token_settings
- AuthenticationTokenSettings
A hitelesítési jogkivonat beállításai, amelyekkel a feladat Batch-szolgáltatásműveleteket hajthat végre. Ha ez a tulajdonság be van állítva, a Batch szolgáltatás egy hitelesítési jogkivonatot biztosít a feladatnak, amely a Batch szolgáltatás műveleteinek hitelesítésére használható fiókhozzáférési kulcs megkövetelése nélkül. A jogkivonatot a AZ_BATCH_AUTHENTICATION_TOKEN környezeti változó biztosítja. A beállításoktól függ, hogy a tevékenység milyen műveleteket hajthat végre a jogkivonat használatával. Egy tevékenység például feladatengedélyeket kérhet, hogy más tevékenységeket vegyen fel a feladatba, vagy ellenőrizze a feladat vagy a feladat alatti egyéb tevékenységek állapotát.
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