PoolAddParameter Osztály
A Azure Batch szolgáltatásban hozzáadandó készlet.
Az Azure-ba való küldéshez minden szükséges paramétert fel kell tölteni.
- Öröklődés
-
PoolAddParameter
Konstruktor
PoolAddParameter(*, id: str, vm_size: str, display_name: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, target_dedicated_nodes: int = None, target_low_priority_nodes: int = None, enable_auto_scale: bool = None, auto_scale_formula: str = None, auto_scale_evaluation_interval=None, enable_inter_node_communication: bool = None, network_configuration=None, start_task=None, certificate_references=None, application_package_references=None, application_licenses=None, task_slots_per_node: int = None, task_scheduling_policy=None, user_accounts=None, metadata=None, mount_configuration=None, target_node_communication_mode=None, **kwargs)Paraméterek
- id
- str
Kötelező. Az azonosító tartalmazhat alfanumerikus karakterek tetszőleges kombinációját, beleértve a kötőjeleket és az aláhúzásokat, és legfeljebb 64 karaktert tartalmazhat. Az azonosító esetmegőrző és kis- és nagybetűket nem érzékelyítő (vagyis előfordulhat, hogy nem rendelkezik két készletazonosí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 hosszúságú Unicode-karaktereket tartalmazhat.
- vm_size
- str
Kötelező. A Cloud Services-készletekhez (a cloudServiceConfiguration használatával létrehozott készletekhez) elérhető virtuális gépek méretével kapcsolatos információkért lásd: Cloud Services méretei (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). A Batch az ExtraSmall, az A1V2 és az A2V2 kivételével minden Cloud Services virtuálisgép-méretet támogat. További információ a Virtual Machines Marketplace rendszerképeit használó készletek rendelkezésre álló virtuálisgép-méreteiről (virtualMachineConfiguration használatával létrehozott készletekről) lásd: Virtual Machines méretei (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) vagy Méretek Virtual Machines (Windows) esetén (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). A Batch az összes Azure-beli virtuálisgép-méretet támogatja, kivéve a STANDARD_A0 és a prémium szintű tárolóval (STANDARD_GS, STANDARD_DS és STANDARD_DSV2 sorozattal rendelkezőket).
- cloud_service_configuration
- CloudServiceConfiguration
A készlet felhőszolgáltatás-konfigurációja. Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiók a poolAllocationMode tulajdonsággal "UserSubscription" értékre van állítva.
- virtual_machine_configuration
- VirtualMachineConfiguration
A készlet virtuálisgép-konfigurációja. Ez a tulajdonság és a cloudServiceConfiguration kölcsönösen kizárja egymást, és meg kell adni az egyik tulajdonságot.
- resize_timeout
- <xref:timedelta>
Ez az időtúllépés csak a manuális skálázásra vonatkozik; nincs hatása, ha az enableAutoScale értéke igaz. Az alapértelmezett érték 15 perc. A minimális érték 5 perc. Ha 5 percnél rövidebb értéket ad meg, a Batch szolgáltatás hibát ad vissza; Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).
- target_dedicated_nodes
- int
A készletben található dedikált számítási csomópontok kívánt száma. Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke igaz. Ha az enableAutoScale értéke hamis, akkor be kell állítania a targetDedicatedNodes, targetLowPriorityNodes vagy mindkettőt.
- target_low_priority_nodes
- int
A készletben található kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma. Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke igaz. Ha az enableAutoScale értéke hamis, akkor be kell állítania a targetDedicatedNodes, targetLowPriorityNodes vagy mindkettőt.
- enable_auto_scale
- bool
Azt jelzi, hogy a készlet méretének idővel automatikusan meg kell-e változnia. Ha hamis, meg kell adni legalább egy targetDedicatedNodes és targetLowPriorityNodes értéket. Ha igaz, az automatikusScaleFormula tulajdonságra van szükség, és a készlet a képletnek megfelelően automatikusan átméreteződik. Az alapértelmezett érték a hamis.
- auto_scale_formula
- str
Ezt a tulajdonságot nem szabad megadni, ha az enableAutoScale értéke hamis. Ez akkor szükséges, ha az enableAutoScale értéke igaz. A készlet létrehozása előtt a rendszer ellenőrzi a képlet érvényességét. Ha a képlet érvénytelen, a Batch szolgáltatás elutasítja a kérelmet részletes hibainformációkkal. A képlet megadásáról további információt a "Számítási csomópontok automatikus méretezése Azure Batch készletben" () című témakörben talál.https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/
- auto_scale_evaluation_interval
- <xref:timedelta>
Az alapértelmezett érték 15 perc. A minimális és maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás hibát ad vissza; Ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés).
- enable_inter_node_communication
- bool
Azt jelzi, hogy a készlet engedélyezi-e a közvetlen kommunikációt a számítási csomópontok között. A csomópontok közötti kommunikáció engedélyezése korlátozza a készlet maximális méretét a készlet számítási csomópontjaira vonatkozó üzembehelyezési korlátozások miatt. Ez azt eredményezheti, hogy a készlet nem éri el a kívánt méretet. Az alapértelmezett érték a hamis.
- start_task
- StartTask
Az egyes számítási csomópontokon a készlethez való csatlakozáskor futtatandó feladat. A feladat akkor fut, amikor a számítási csomópont hozzá van adva a készlethez, vagy amikor a számítási csomópont újraindul.
- certificate_references
- list[CertificateReference]
Windows-csomópontok esetén a Batch szolgáltatás telepíti a tanúsítványokat a megadott tanúsítványtárolóba és helyre. Linux számítási csomópontok esetén a tanúsítványok a Feladat munkakönyvtárában található könyvtárban vannak tárolva, és a rendszer egy környezeti változót AZ_BATCH_CERTIFICATES_DIR a feladatnak, amely lekérdezi ezt a helyet. A "remoteUser" láthatóságú tanúsítványok esetében a rendszer létrehoz egy "tanúsítvány" könyvtárat a felhasználó kezdőkönyvtárában (pl. /home/{user-name}/certs), és a tanúsítványok ebben a könyvtárban vannak elhelyezve. Figyelmeztetés: Ez a tulajdonság elavult, és 2024 februárja után törlődik. Használja inkább az Azure KeyVault bővítményt .
- application_package_references
- list[ApplicationPackageReference]
Készlet létrehozásakor a csomag alkalmazásazonosítójának teljes mértékben minősítettnek kell lennie (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). A Csomaghivatkozások módosítása hatással van a készlethez csatlakozó összes új csomópontra, de nem érinti azokat a számítási csomópontokat, amelyek már a készletben vannak, amíg újra nem indítják vagy újra nem alakítják őket. Egy adott készleten legfeljebb 10 csomaghivatkozás található.
Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek egy részhalmazának kell lennie. Ha olyan licencet kérnek, amely nem támogatott, a készlet létrehozása sikertelen lesz.
- task_slots_per_node
- int
A készlet egyetlen számítási csomópontján egyidejű feladatok futtatására használható feladathelyek száma. Az alapértelmezett érték az 1. A maximális érték a készlet vmSize magjainak számának négyszerese vagy 256.
- task_scheduling_policy
- TaskSchedulingPolicy
A tevékenységek elosztása a készlet számítási csomópontjai között. Ha nincs megadva, az alapértelmezett oldalpár.
- user_accounts
- list[UserAccount]
- 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 szolgál.
- mount_configuration
- list[MountConfiguration]
Csatlakoztassa a tárolót az Azure Fileshare, az NFS, a CIFS vagy a Blobfuse alapú fájlrendszer használatával.
- target_node_communication_mode
- str vagy NodeCommunicationMode
A készlet kívánt csomópontkommunikációs módja. Ha nincs megadva, az alapértelmezett érték az Alapértelmezett. Lehetséges értékek: "alapértelmezett", "klasszikus", "egyszerűsített"
Metódusok
| as_dict |
A json.dump használatával JSONify formátumú diktált értéket ad vissza. 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 egy metaadat-diktálás. Jelenleg az msrest típust és a RestAPI kódolt kulcsot tartalmazó "típust" tartalmazza. 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 ez hierarchikus eredménydiktátumnak minősül. Tekintse meg a fájl három példáját:
Ha XML-szerializálást szeretne, a kwargs is_xml=True értéket is átadhatja. |
| deserialize |
Elemezhet egy str értéket a RestAPI szintaxissal, és visszaad egy modellt. |
| enable_additional_properties_sending | |
| from_dict |
Egy diktálás elemzése adott kulcselszívó használatával egy modellt ad vissza. 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 |
Adja vissza a modellből az Azure-ba küldendő JSON-t. Ez a as_dict (full_restapi_key_transformer, keep_readonly=False) aliasa. Ha XML-szerializálást szeretne, a kwargs is_xml=True értéket is átadhatja. |
| validate |
Ellenőrizze ezt a modellt rekurzív módon, és adja vissza a ValidationError listáját. |
as_dict
A json.dump használatával JSONify formátumú diktált értéket ad vissza.
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 egy metaadat-diktálás. Jelenleg az msrest típust és a RestAPI kódolt kulcsot tartalmazó "típust" tartalmazza. 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 ez hierarchikus eredménydiktátumnak minősül.
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, a kwargs is_xml=True értéket is átadhatja.
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
Diktátum JSON-kompatibilis objektum
Visszatérési típus
deserialize
Elemezhet egy str értéket a RestAPI szintaxissal, és visszaad egy modellt.
deserialize(data, content_type=None)Paraméterek
- content_type
- str
JSON alapértelmezés szerint állítsa be az alkalmazást/xml-t, ha XML.
Válaszok
A modell egy példánya
Kivételek
enable_additional_properties_sending
enable_additional_properties_sending()from_dict
Egy diktálás elemzése adott kulcselszívó használatával egy modellt ad vissza.
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
JSON alapértelmezés szerint állítsa be az alkalmazást/xml-t, ha XML.
- key_extractors
Válaszok
A modell egy példánya
Kivételek
is_xml_model
is_xml_model()serialize
Adja vissza a modellből az Azure-ba küldendő JSON-t.
Ez a as_dict (full_restapi_key_transformer, keep_readonly=False) aliasa.
Ha XML-szerializálást szeretne, a kwargs is_xml=True értéket is átadhatja.
serialize(keep_readonly=False, **kwargs)Paraméterek
- keep_readonly
- bool
Ha szerializálni szeretné az olvasható attribútumokat
Válaszok
Diktátum JSON-kompatibilis objektum
Visszatérési típus
validate
Ellenőrizze ezt 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: