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.ProxyResourcePool
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
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.
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".
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.
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".
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.
Azure SDK for Python