CloudPool Třída

Fond ve službě Azure Batch.

Proměnné jsou naplněné pouze serverem a při odesílání požadavku budou ignorovány.

Dědičnost

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)

Parametry

id

str

Vyžadováno

ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně spojovníků a podtržítků a nesmí obsahovat více než 64 znaků. ID zachovává malá a velká písmena a nerozlišuje velká a malá písmena (to znamená, že v rámci účtu nemusíte mít dvě ID, která se liší pouze velikostí písmen).

display_name

str

Vyžadováno

Zobrazovaný název nemusí být jedinečný a může obsahovat jakékoli znaky Unicode až do maximální délky 1024.

url

str

Vyžadováno

e_tag

str

Vyžadováno

Jedná se o neprůzrůzný řetězec. Můžete ho použít ke zjištění, jestli se fond mezi požadavky změnil. Konkrétně můžete při aktualizaci fondu předat eTag a určit, že změny se mají projevit pouze v případě, že mezitím fond nikdo jiný neupravoval.

last_modified

datetime

Vyžadováno

Jedná se o poslední čas, kdy se změnila data na úrovni fondu, například nastavení targetDedicatedNodes nebo enableAutoscale. Nebere v potaz změny na úrovni uzlu, jako je změna stavu výpočetního uzlu.

creation_time

datetime

Vyžadováno

state

str nebo PoolState

Vyžadováno

Mezi možné hodnoty patří: "aktivní", "odstranění"

state_transition_time

datetime

Vyžadováno

allocation_state

str nebo AllocationState

Vyžadováno

Mezi možné hodnoty patří: "steady", 'resizing', 'stopping'

allocation_state_transition_time

datetime

Vyžadováno

vm_size

str

Vyžadováno

Informace o dostupných velikostech virtuálních počítačů ve fondech najdete v tématu Volba velikosti virtuálního počítače pro výpočetní uzly v Azure Batch fondu (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

cloud_service_configuration

CloudServiceConfiguration

Vyžadováno

Konfigurace cloudové služby pro fond Tato vlastnost a virtualMachineConfiguration se vzájemně vylučují a jedna z vlastností musí být zadána. Tuto vlastnost nelze zadat, pokud byl účet Batch vytvořen s vlastností poolAllocationMode nastavenou na hodnotu UserSubscription.

virtual_machine_configuration

VirtualMachineConfiguration

Vyžadováno

Konfigurace virtuálního počítače pro fond. Tato vlastnost a cloudServiceConfiguration se vzájemně vylučují a musí být zadána jedna z vlastností.

resize_timeout

<xref:timedelta>

Vyžadováno

Toto je časový limit poslední operace změny velikosti. (Počáteční změna velikosti při vytvoření fondu se počítá jako změna velikosti.) Výchozí hodnota je 15 minut.

resize_errors

list[ResizeError]

Vyžadováno

Tato vlastnost je nastavena pouze v případě, že došlo k jedné nebo více chybám během poslední změny velikosti fondu, a pouze v případě, že je stav přidělení fondu stabilní.

current_dedicated_nodes

int

Vyžadováno

Počet vyhrazených výpočetních uzlů, které jsou aktuálně ve fondu.

current_low_priority_nodes

int

Vyžadováno

Počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou, které jsou aktuálně ve fondu. Do tohoto počtu se započítávají spotové výpočetní uzly nebo výpočetní uzly s nízkou prioritou, které byly zrušeny.

target_dedicated_nodes

int

Vyžadováno

Požadovaný počet vyhrazených výpočetních uzlů ve fondu

target_low_priority_nodes

int

Vyžadováno

Požadovaný počet spotových výpočetních uzlů nebo výpočetních uzlů s nízkou prioritou ve fondu

enable_auto_scale

bool

Vyžadováno

Určuje, jestli se má velikost fondu v průběhu času automaticky upravovat. Pokud false, musí být zadána alespoň jedna z targetDedicatedNodes a targetLowPriorityNodes. Pokud je hodnota true, vlastnost autoScaleFormula je povinná a velikost fondu se automaticky změní podle vzorce. Výchozí hodnota je False.

auto_scale_formula

str

Vyžadováno

Tato vlastnost je nastavena pouze v případě, že se fond automaticky škáluje, tj. enableAutoScale má hodnotu true.

auto_scale_evaluation_interval

<xref:timedelta>

Vyžadováno

Tato vlastnost je nastavena pouze v případě, že se fond automaticky škáluje, tj. enableAutoScale má hodnotu true.

auto_scale_run

AutoScaleRun

Vyžadováno

Výsledky a chyby z posledního spuštění vzorce automatického škálování Tato vlastnost je nastavena pouze v případě, že se fond automaticky škáluje, tj. enableAutoScale má hodnotu true.

enable_inter_node_communication

bool

Vyžadováno

Určuje, jestli fond umožňuje přímou komunikaci mezi výpočetními uzly. Tím se stanoví omezení, které výpočetní uzly je možné přiřadit k fondu. Zadání této hodnoty může snížit riziko přidělení požadovaného počtu výpočetních uzlů ve fondu.

network_configuration

NetworkConfiguration

Vyžadováno

Konfigurace sítě pro fond.

start_task

StartTask

Vyžadováno

Úkol určený ke spuštění na každém výpočetním uzlu při připojení k fondu.

certificate_references

list[CertificateReference]

Vyžadováno

V případě uzlů Windows služba Batch nainstaluje certifikáty do zadaného úložiště a umístění certifikátů. V případě linuxových výpočetních uzlů jsou certifikáty uložené v adresáři v pracovním adresáři úlohy a proměnná prostředí AZ_BATCH_CERTIFICATES_DIR je předána úkolu, který se má dotazovat na toto umístění. V případě certifikátů s viditelností remoteUser se adresář certs vytvoří v domovském adresáři uživatele (např. /home/{uživatelské_jméno}/certs) a certifikáty se umístí do tohoto adresáře. Upozornění: Tato vlastnost je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .

application_package_references

list[ApplicationPackageReference]

Vyžadováno

Změny odkazů na balíčky ovlivní všechny nové uzly, které se připojují k fondu, ale nemají vliv na výpočetní uzly, které už jsou ve fondu, dokud se nerestartují nebo nereimagí. V každém daném fondu je maximálně 10 odkazů na balíčky.

application_licenses

list[str]

Vyžadováno

Seznam licencí aplikací musí být podmnožinou dostupných licencí aplikací služby Batch. Pokud je požadována licence, která není podporována, vytvoření fondu se nezdaří.

task_slots_per_node

int

Vyžadováno

Počet slotů úloh, které lze použít ke spouštění souběžných úloh na jednom výpočetním uzlu ve fondu. Výchozí hodnota je 1. Maximální hodnota je menší ze 4násobku počtu jader vmSize fondu nebo 256.

task_scheduling_policy

TaskSchedulingPolicy

Vyžadováno

Způsob distribuce úkolů mezi výpočetní uzly ve fondu Pokud není zadaný, je výchozí hodnota rozložena.

user_accounts

list[UserAccount]

Vyžadováno

metadata

list[MetadataItem]

Vyžadováno

stats

PoolStatistics

Vyžadováno

Statistika využití a využití prostředků za celou dobu životnosti fondu. Tato vlastnost je naplněna pouze v případě, že CloudPool byl načten s expand klauzule, včetně 'stats' atributu; v opačném případě je null. Statistika nemusí být okamžitě dostupná. Služba Batch pravidelně shrnuje statistiky. Typické zpoždění je přibližně 30 minut.

mount_configuration

list[MountConfiguration]

Vyžadováno

To podporuje Azure Files, NFS, CIFS/SMB a Blobfuse.

identity

BatchPoolIdentity

Vyžadováno

Identita fondu Batch, pokud je nakonfigurovaná. Seznam identit uživatelů přidružených k fondu služby Batch. Odkazy na klíče slovníku identit uživatelů budou ID prostředků ARM ve formátu//subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

target_node_communication_mode

str nebo NodeCommunicationMode

Vyžadováno

Požadovaný režim komunikace uzlu pro fond. Pokud ho vynecháte, výchozí hodnota je Výchozí. Mezi možné hodnoty patří: 'default', 'classic', 'simplified'

Proměnné

current_node_communication_mode

str nebo NodeCommunicationMode

Aktuální stav režimu komunikace fondu. Mezi možné hodnoty patří: 'default', 'classic', 'simplified'

Metody

as_dict	Vrácení diktování, které může být JSONify pomocí json.dump. Rozšířené použití může jako parametr volitelně použít zpětné volání: Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. Aktuálně obsahuje 'type' s typem msrest a 'key' s klíčem kódovaným RestAPI. Value je aktuální hodnota v tomto objektu. Vrácený řetězec se použije k serializaci klíče. Pokud je návratovým typem seznam, považuje se to za hierarchický dikt výsledku. Podívejte se na tři příklady v tomto souboru: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.
deserialize	Parsujte str pomocí syntaxe RestAPI a vraťte model.
enable_additional_properties_sending
from_dict	Parsování diktování pomocí daného extraktoru klíčů vrátí model. Ve výchozím nastavení zvažte extraktory klíčů (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor a last_rest_key_case_insensitive_extractor).
is_xml_model
serialize	Vrátí kód JSON, který se z tohoto modelu odešle do Azure. Toto je alias pro as_dict(full_restapi_key_transformer, keep_readonly=False). Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.
validate	Rekurzivně ověřte tento model a vraťte seznam ValidationError.

as_dict

Vrácení diktování, které může být JSONify pomocí json.dump.

Rozšířené použití může jako parametr volitelně použít zpětné volání:

Klíč je název atributu, který se používá v Pythonu. Attr_desc je dikt metadat. Aktuálně obsahuje 'type' s typem msrest a 'key' s klíčem kódovaným RestAPI. Value je aktuální hodnota v tomto objektu.

Vrácený řetězec se použije k serializaci klíče. Pokud je návratovým typem seznam, považuje se to za hierarchický dikt výsledku.

Podívejte se na tři příklady v tomto souboru:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Parametry

key_transformer

<xref:function>

Funkce klíčového transformátoru.

keep_readonly

výchozí hodnota: True

Návraty

Objekt kompatibilní se dict JSON

Návratový typ

dict

deserialize

Parsujte str pomocí syntaxe RestAPI a vraťte model.

deserialize(data, content_type=None)

Parametry

data

str

Vyžadováno

Str využívající strukturu RestAPI. Json ve výchozím nastavení.

content_type

str

výchozí hodnota: None

Ve výchozím nastavení JSON nastavte application/xml, pokud XML.

Návraty

Instance tohoto modelu

Výjimky

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Parsování diktování pomocí daného extraktoru klíčů vrátí model.

Ve výchozím nastavení zvažte extraktory klíčů (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor a last_rest_key_case_insensitive_extractor).

from_dict(data, key_extractors=None, content_type=None)

Parametry

data

dict

Vyžadováno

A dict using RestAPI structure

content_type

str

výchozí hodnota: None

Ve výchozím nastavení JSON nastavte application/xml, pokud XML.

key_extractors

výchozí hodnota: None

Návraty

Instance tohoto modelu

Výjimky

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Vrátí kód JSON, který se z tohoto modelu odešle do Azure.

Toto je alias pro as_dict(full_restapi_key_transformer, keep_readonly=False).

Pokud chcete serializaci XML, můžete předat kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Parametry

keep_readonly

bool

výchozí hodnota: False

Pokud chcete serializovat atributy readonly

Návraty

Objekt kompatibilní se dict JSON

Návratový typ

dict

validate

Rekurzivně ověřte tento model a vraťte seznam ValidationError.

validate()

Návraty

Seznam chyb ověření

Návratový typ

list