Freigeben über


Pool Klasse

Enthält Informationen zu einem Pool.

Variablen werden nur vom Server aufgefüllt und beim Senden einer Anforderung ignoriert.

Vererbung
azure.mgmt.batch.models._models_py3.ProxyResource
Pool

Konstruktor

Pool(*, identity: _models.BatchPoolIdentity | None = None, display_name: str | None = None, vm_size: str | None = None, deployment_configuration: _models.DeploymentConfiguration | None = None, scale_settings: _models.ScaleSettings | None = None, inter_node_communication: str | _models.InterNodeCommunicationState | None = None, network_configuration: _models.NetworkConfiguration | None = None, task_slots_per_node: int = 1, task_scheduling_policy: _models.TaskSchedulingPolicy | None = None, user_accounts: List[_models.UserAccount] | None = None, metadata: List[_models.MetadataItem] | None = None, start_task: _models.StartTask | None = None, certificates: List[_models.CertificateReference] | None = None, application_packages: List[_models.ApplicationPackageReference] | None = None, application_licenses: List[str] | None = None, mount_configuration: List[_models.MountConfiguration] | None = None, target_node_communication_mode: str | _models.NodeCommunicationMode | None = None, resource_tags: Dict[str, str] | None = None, **kwargs: Any)

Keyword-Only Parameters

identity
BatchPoolIdentity

Der Identitätstyp, der für den Batchpool verwendet wird.

display_name
str

Der Anzeigename muss nicht eindeutig sein und kann Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.

vm_size
str

Informationen zu den verfügbaren Größen virtueller Computer für Cloud Services Pools (Pools, die mit cloudServiceConfiguration erstellt wurden) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle Cloud Services VM-Größen mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools, die Images aus dem Virtual Machines Marketplace verwenden (Mit virtualMachineConfiguration erstellte Pools) finden Sie unter Größen für Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure-VM-Größen mit Ausnahme von STANDARD_A0 und solchen mit Storage Premium (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).

deployment_configuration
DeploymentConfiguration

Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet.

scale_settings
ScaleSettings

Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem der angeforderte targetDedicatedNodes angegeben wird, oder "autoScale", der eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben wird, verfügt der Pool über eine feste Skalierung mit 0 targetDedicatedNodes.

inter_node_communication
str oder InterNodeCommunicationState

Dies erzwingt Einschränkungen, welche Knoten dem Pool zugewiesen werden können. Das Aktivieren dieses Werts kann die Wahrscheinlichkeit verringern, dass die angeforderte Anzahl von Knoten im Pool zugewiesen wird. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. Bekannte Werte sind: "Aktiviert" und "Deaktiviert".

network_configuration
NetworkConfiguration

Die Netzwerkkonfiguration für einen Pool.

task_slots_per_node
int
Standardwert: 1

Der Standardwert ist 1. Der Maximalwert ist der 4-fache der Anzahl der Kerne der vmSize des Pools oder 256.

task_scheduling_policy
TaskSchedulingPolicy

Wenn nicht angegeben, ist der Standardwert Spread.

user_accounts
list[UserAccount]

Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen.

metadata
list[MetadataItem]

Der Batch-Dienst weist Metadaten keine Bedeutung zu. es dient ausschließlich der Verwendung von Benutzercode.

start_task
StartTask

In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um den Starttask aus dem Pool zu entfernen.

certificates
list[CertificateReference]

Bei Windows-Computeknoten installiert der Batch-Dienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Aufgabenarbeitsverzeichnisses gespeichert, und eine Umgebungsvariable, AZ_BATCH_CERTIFICATES_DIR für die Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Bei Zertifikaten mit sichtbarkeit von "remoteUser" wird im Basisverzeichnis des Benutzers (z. B. /home/{benutzername}/certs) ein Verzeichnis "certs" erstellt, und zertifikate werden in diesem Verzeichnis abgelegt.

Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .

application_packages
list[ApplicationPackageReference]

Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, aber nicht auf Computeknoten, die sich bereits im Pool befinden, bis sie neu gestartet oder neu erstellt werden. Es gibt maximal 10 Anwendungspaketverweise in einem bestimmten Pool.

application_licenses
list[str]

Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batch-Dienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl.

mount_configuration
list[MountConfiguration]

Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse.

target_node_communication_mode
str oder NodeCommunicationMode

Wenn nicht angegeben, lautet der Standardwert Default. Bekannte Werte sind: "Default", "Classic" und "Simplified".

resource_tags
dict[str, str]

Die benutzerdefinierten Tags, die dem Azure Batch Pool zugeordnet werden sollen. Bei Angabe werden diese Tags an die dem Pool zugeordneten unterstützenden Azure-Ressourcen weitergegeben. Diese Eigenschaft kann nur angegeben werden, wenn das Batch-Konto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde.

Variablen

id
str

Die ID der Ressource.

name
str

Der Name der Ressource.

type
str

Der Typ der Ressource.

etag
str

Das ETag der Ressource, die für Parallelitätsanweisungen verwendet wird.

identity
BatchPoolIdentity

Der Identitätstyp, der für den Batchpool verwendet wird.

display_name
str

Der Anzeigename muss nicht eindeutig sein und kann Unicode-Zeichen bis zu einer maximalen Länge von 1024 enthalten.

last_modified
datetime

Dies ist der letzte Zeitpunkt, zu dem die Daten auf Poolebene, z. B. targetDedicatedNodes oder autoScaleSettings, geändert wurden. Änderungen auf Knotenebene, z. B. die Änderung des Zustands eines Computeknotens, werden nicht mit eingerechnet.

creation_time
datetime

Die Erstellungszeit des Pools.

provisioning_state
str oder PoolProvisioningState

Der aktuelle Zustand des Pools. Bekannte Werte sind: "Erfolgreich" und "Löschen".

provisioning_state_transition_time
datetime

Der Zeitpunkt, zu dem der Pool seinen aktuellen Status erlangt hat.

allocation_state
str oder AllocationState

Gibt an, ob die Größe des Pools geändert wird. Bekannte Werte sind: "Steady", "Ändern der Größe" und "Stop".

allocation_state_transition_time
datetime

Der Zeitpunkt, zu dem der Pool seinen aktuellen Zuordnungsstatus erlangt hat.

vm_size
str

Informationen zu den verfügbaren Größen virtueller Computer für Cloud Services Pools (Pools, die mit cloudServiceConfiguration erstellt wurden) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle Cloud Services VM-Größen mit Ausnahme von ExtraSmall. Informationen zu verfügbaren VM-Größen für Pools, die Images aus dem Virtual Machines Marketplace verwenden (Mit virtualMachineConfiguration erstellte Pools) finden Sie unter Größen für Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure-VM-Größen mit Ausnahme von STANDARD_A0 und solchen mit Storage Premium (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).

deployment_configuration
DeploymentConfiguration

Die Verwendung von CloudServiceConfiguration gibt an, dass die Knoten mithilfe von Azure Cloud Services (PaaS) erstellt werden sollen, während VirtualMachineConfiguration Azure Virtual Machines (IaaS) verwendet.

current_dedicated_nodes
int

Die Anzahl der dedizierten Computeknoten, die sich derzeit im Pool befinden.

current_low_priority_nodes
int

Die Anzahl der Computeknoten mit spot/low-priority, die sich derzeit im Pool befinden.

scale_settings
ScaleSettings

Definiert die gewünschte Größe des Pools. Dies kann entweder "fixedScale" sein, bei dem der angeforderte targetDedicatedNodes angegeben wird, oder "autoScale", der eine Formel definiert, die regelmäßig neu ausgewertet wird. Wenn diese Eigenschaft nicht angegeben wird, verfügt der Pool über eine feste Skalierung mit 0 targetDedicatedNodes.

auto_scale_run
AutoScaleRun

Diese Eigenschaft wird nur festgelegt, wenn der Pool automatisch skaliert, d. h. autoScaleSettings verwendet wird.

inter_node_communication
str oder InterNodeCommunicationState

Dies erzwingt Einschränkungen, welche Knoten dem Pool zugewiesen werden können. Das Aktivieren dieses Werts kann die Wahrscheinlichkeit verringern, dass die angeforderte Anzahl von Knoten im Pool zugewiesen wird. Wenn nicht angegeben, wird dieser Wert standardmäßig auf "Deaktiviert" festgelegt. Bekannte Werte sind: "Aktiviert" und "Deaktiviert".

network_configuration
NetworkConfiguration

Die Netzwerkkonfiguration für einen Pool.

task_slots_per_node
int

Der Standardwert ist 1. Der Maximalwert ist der 4-fache der Anzahl der Kerne der vmSize des Pools oder 256.

task_scheduling_policy
TaskSchedulingPolicy

Wenn nicht angegeben, ist der Standardwert Spread.

user_accounts
list[UserAccount]

Die Liste der Benutzerkonten, die auf jedem Knoten im Pool erstellt werden sollen.

metadata
list[MetadataItem]

Der Batch-Dienst weist Metadaten keine Bedeutung zu. es dient ausschließlich der Verwendung von Benutzercode.

start_task
StartTask

In einem PATCH-Vorgang (Update) kann diese Eigenschaft auf ein leeres Objekt festgelegt werden, um den Starttask aus dem Pool zu entfernen.

certificates
list[CertificateReference]

Bei Windows-Computeknoten installiert der Batch-Dienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Aufgabenarbeitsverzeichnisses gespeichert, und eine Umgebungsvariable, AZ_BATCH_CERTIFICATES_DIR für die Aufgabe bereitgestellt wird, um diesen Speicherort abzufragen. Bei Zertifikaten mit sichtbarkeit von "remoteUser" wird im Basisverzeichnis des Benutzers (z. B. /home/{benutzername}/certs) ein Verzeichnis "certs" erstellt, und zertifikate werden in diesem Verzeichnis abgelegt.

Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .

application_packages
list[ApplicationPackageReference]

Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, aber nicht auf Computeknoten, die sich bereits im Pool befinden, bis sie neu gestartet oder neu erstellt werden. Es gibt maximal 10 Anwendungspaketverweise in einem bestimmten Pool.

application_licenses
list[str]

Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batch-Dienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl.

resize_operation_status
ResizeOperationStatus

Beschreibt entweder den aktuellen Vorgang (wenn der Pool AllocationState die Größe ändert) oder den zuvor abgeschlossenen Vorgang (wenn der AllocationState steady ist).

mount_configuration
list[MountConfiguration]

Dies unterstützt Azure Files, NFS, CIFS/SMB und Blobfuse.

target_node_communication_mode
str oder NodeCommunicationMode

Wenn nicht angegeben, lautet der Standardwert Default. Bekannte Werte sind: "Default", "Classic" und "Simplified".

current_node_communication_mode
str oder NodeCommunicationMode

Bestimmt, wie ein Pool mit dem Batch-Dienst kommuniziert. Bekannte Werte sind: "Default", "Classic" und "Simplified".

resource_tags
dict[str, str]

Die benutzerdefinierten Tags, die dem Azure Batch Pool zugeordnet werden sollen. Bei Angabe werden diese Tags an die dem Pool zugeordneten unterstützenden Azure-Ressourcen weitergegeben. Diese Eigenschaft kann nur angegeben werden, wenn das Batch-Konto mit der poolAllocationMode-Eigenschaft auf "UserSubscription" festgelegt wurde.