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

Model

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ő

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

Kötelező

A megjelenítendő névnek nem kell egyedinek lennie, és legfeljebb 1024 karakter hosszúságú Unicode-karaktereket tartalmazhat.

command_line

str

Kötelező

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

Kötelező

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

Kötelező

Hogyan reagáljon a Batch szolgáltatás a feladat befejezésekor?

resource_files

list[ResourceFile]

Kötelező

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]

Kötelező

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]

Kötelező

affinity_info

AffinityInformation

Kötelező

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

Kötelező

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

Kötelező

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

Kötelező

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

Kötelező

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

Kötelező

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]

Kötelező

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

Kötelező

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: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer 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

alapértelmezett érték: True

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

dict

deserialize

Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.

deserialize(data, content_type=None)

Paraméterek

data

str

Kötelező

RestAPI-struktúrát használó struktúra. JSON alapértelmezés szerint.

content_type

str

alapértelmezett érték: None

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

DeserializationError if something went wrong

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

data

dict

Kötelező

Egy restAPI-struktúrát használó diktálás

content_type

str

alapértelmezett érték: None

A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.

key_extractors

alapértelmezett érték: None

Válaszok

A modell egy példánya

Kivételek

DeserializationError if something went wrong

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

alapértelmezett érték: False

Ha szerializálni szeretné az olvasható attribútumokat

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

dict

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

list