CloudPool Osztály

Egy készlet a Azure Batch szolgáltatásban.

A változókat csak a kiszolgáló tölti ki, és a rendszer figyelmen kívül hagyja a kérés küldésekor.

Öröklődés

Model

CloudPool

Konstruktor

CloudPool(*, id: str = None, display_name: str = None, url: str = None, e_tag: str = None, last_modified=None, creation_time=None, state=None, state_transition_time=None, allocation_state=None, allocation_state_transition_time=None, vm_size: str = None, cloud_service_configuration=None, virtual_machine_configuration=None, resize_timeout=None, resize_errors=None, current_dedicated_nodes: int = None, current_low_priority_nodes: int = 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, auto_scale_run=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, stats=None, mount_configuration=None, identity=None, target_node_communication_mode=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

Kötelező

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

url

str

Kötelező

e_tag

str

Kötelező

Ez egy átlátszatlan sztring. Segítségével megállapíthatja, hogy a készlet megváltozott-e a kérések között. A készlet frissítésekor átadhatja az ETaget, így megadhatja, hogy a módosítások csak akkor lépnek érvénybe, ha időközben senki más nem módosította a készletet.

last_modified

datetime

Kötelező

Ez az utolsó alkalom, amikor a készletszintű adatok, például a targetDedicatedNodes vagy az enableAutoscale beállítások módosultak. Nem befolyásolja a csomópontszintű változásokat, például a számítási csomópontok változó állapotát.

creation_time

datetime

Kötelező

state

str vagy PoolState

Kötelező

Lehetséges értékek: "aktív", "törlés"

state_transition_time

datetime

Kötelező

allocation_state

str vagy AllocationState

Kötelező

Lehetséges értékek: "állandó", "átméretezés", "leállítás"

allocation_state_transition_time

datetime

Kötelező

vm_size

str

Kötelező

A készletekben elérhető virtuális gépek méretével kapcsolatos információkért lásd: Virtuálisgép-méret kiválasztása számítási csomópontokhoz egy Azure Batch készletben (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

cloud_service_configuration

CloudServiceConfiguration

Kötelező

A készlet felhőszolgáltatás-konfigurációja. Ez a tulajdonság és a virtualMachineConfiguration kölcsönösen kizáróak, és meg kell adni az egyik tulajdonságot. Ez a tulajdonság nem adható meg, ha a Batch-fiókot a poolAllocationMode tulajdonsággal hozták létre, és "UserSubscription" értékre van állítva.

virtual_machine_configuration

VirtualMachineConfiguration

Kötelező

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>

Kötelező

Ez a legutóbbi átméretezési művelet időtúllépése. (A készlet létrehozásakor a kezdeti méretezés átméretezésnek számít.) Az alapértelmezett érték 15 perc.

resize_errors

list[ResizeError]

Kötelező

Ez a tulajdonság csak akkor van beállítva, ha egy vagy több hiba történt a készlet legutóbbi átméretezése során, és csak akkor, ha a készlet foglalási állapota Állandó.

current_dedicated_nodes

int

Kötelező

A készletben jelenleg található dedikált számítási csomópontok száma.

current_low_priority_nodes

int

Kötelező

A készletben jelenleg található kihasználatlan/alacsony prioritású számítási csomópontok száma. A kihasználatlan/alacsony prioritású számítási csomópontok, amelyek már ki vannak állítva, ebben a számban szerepelnek.

target_dedicated_nodes

int

Kötelező

A készletben található dedikált számítási csomópontok kívánt száma.

target_low_priority_nodes

int

Kötelező

A készletben lévő kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma.

enable_auto_scale

bool

Kötelező

Azt határozza meg, hogy a készlet mérete idővel automatikusan módosuljon-e. Ha hamis, meg kell adni legalább egy targetDedicatedNodes és targetLowPriorityNodes paramétert. Ha igaz, az autoScaleFormula tulajdonság megadása kötelező, és a készlet a képletnek megfelelően automatikusan átméreteződik. Az alapértelmezett érték a hamis.

auto_scale_formula

str

Kötelező

Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

auto_scale_evaluation_interval

<xref:timedelta>

Kötelező

Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

auto_scale_run

AutoScaleRun

Kötelező

Az automatikus skálázási képlet legutóbbi végrehajtásának eredményei és hibái. Ez a tulajdonság csak akkor van beállítva, ha a készlet automatikusan skáláz, azaz az enableAutoScale értéke igaz.

enable_inter_node_communication

bool

Kötelező

Lehetővé teszi-e a készlet a számítási csomópontok közötti közvetlen kommunikációt. Ez korlátozza, hogy mely számítási csomópontok rendelhetők hozzá a készlethez. Ennek az értéknek a megadása csökkentheti a készletben lefoglalandó számítási csomópontok kért számának esélyét.

network_configuration

NetworkConfiguration

Kötelező

A készlet hálózati konfigurációja.

start_task

StartTask

Kötelező

Az egyes számítási csomópontokon a készlethez való csatlakozáskor futtatandó feladat.

certificate_references

list[CertificateReference]

Kötelező

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 Tevékenység munkakönyvtárban 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ánykönyvtárat a felhasználó kezdőkönyvtárában (például /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 el lesz távolítva. Használja helyette az Azure KeyVault bővítményt .

application_package_references

list[ApplicationPackageReference]

Kötelező

A Csomaghivatkozások módosítása hatással van a készlethez csatlakozó összes új csomópontra, de nem érinti a készletben lévő számítási csomópontokat, amíg újra nem indítja vagy újra nem alakítja őket. Egy adott készleten legfeljebb 10 csomaghivatkozás lehet.

application_licenses

list[str]

Kötelező

Az alkalmazáslicencek listájának az elérhető Batch-szolgáltatásalkalmazás-licencek 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

Kötelező

Azon feladathelyek száma, amelyek a készlet egyetlen számítási csomópontján egyidejű feladatok futtatására használhatók. Az alapértelmezett érték az 1. A maximális érték a készlet vmSize magjainak számának 4-szerese vagy 256-nak a kisebb.

task_scheduling_policy

TaskSchedulingPolicy

Kötelező

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]

Kötelező

metadata

list[MetadataItem]

Kötelező

stats

PoolStatistics

Kötelező

A készlet teljes élettartama kihasználtsági és erőforrás-használati statisztikái. Ez a tulajdonság csak akkor lesz feltöltve, ha a CloudPool kibontási záradékkal lett beolvasva, beleértve a "stats" attribútumot; ellenkező esetben null értékű. Előfordulhat, hogy a statisztikák nem érhetők el azonnal. A Batch szolgáltatás rendszeres időközönként összesít statisztikákat. A késés általában körülbelül 30 perc.

mount_configuration

list[MountConfiguration]

Kötelező

Ez támogatja a Azure Files, az NFS, a CIFS/SMB és a Blobfuse használatát.

identity

BatchPoolIdentity

Kötelező

A Batch-készlet identitása, ha konfigurálva van. A Batch-készlethez társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai ARM-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

target_node_communication_mode

str vagy NodeCommunicationMode

Kötelező

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: "default", "classic", "egyszerűsített"

Változók

current_node_communication_mode

str vagy NodeCommunicationMode

A készlet kommunikációs üzemmódjának aktuális állapota. Lehetséges értékek: "alapértelmezett", "klasszikus", "egyszerűsített"

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