PoolOperations.ResizePoolAsync Methode

Definition

Namespace:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paket:

Microsoft.Azure.Batch v16.0.0

Ändert die Größe des angegebenen Pools.

public System.Threading.Tasks.Task ResizePoolAsync (string poolId, int? targetDedicatedComputeNodes = default, int? targetLowPriorityComputeNodes = default, TimeSpan? resizeTimeout = default, Microsoft.Azure.Batch.Common.ComputeNodeDeallocationOption? deallocationOption = default, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default, System.Threading.CancellationToken cancellationToken = default);

member this.ResizePoolAsync : string * Nullable<int> * Nullable<int> * Nullable<TimeSpan> * Nullable<Microsoft.Azure.Batch.Common.ComputeNodeDeallocationOption> * seq<Microsoft.Azure.Batch.BatchClientBehavior> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ResizePoolAsync (poolId As String, Optional targetDedicatedComputeNodes As Nullable(Of Integer) = Nothing, Optional targetLowPriorityComputeNodes As Nullable(Of Integer) = Nothing, Optional resizeTimeout As Nullable(Of TimeSpan) = Nothing, Optional deallocationOption As Nullable(Of ComputeNodeDeallocationOption) = Nothing, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

poolId

String

Die ID des Pools.

targetDedicatedComputeNodes

Nullable<Int32>

Die gewünschte Anzahl dedizierter Computeknoten im Pool. Mindestens eine von targetDedicatedComputeNodes und targetLowPriorityComputeNodes ist erforderlich.

targetLowPriorityComputeNodes

Nullable<Int32>

Die gewünschte Anzahl von Computeknoten mit niedriger Priorität im Pool. Mindestens eine von targetDedicatedComputeNodes und targetLowPriorityComputeNodes ist erforderlich.

resizeTimeout

Nullable<TimeSpan>

Das Timeout für die Zuordnung von Computeknoten zum Pool oder das Entfernen von Computeknoten aus dem Pool. Wenn der Pool die Zielgröße nach diesem Zeitpunkt nicht erreicht hat, wird die Größenänderung beendet. Der Standardwert ist 15 Minuten.

deallocationOption

Nullable<ComputeNodeDeallocationOption>

Gibt an, wie bereits ausgeführte Aufgaben behandelt werden und wann die Knoten, auf denen diese ausgeführt werden, aus dem Pool entfernt werden können, wenn die Poolgröße abnimmt. Der Standardwert ist Requeue.

additionalBehaviors

IEnumerable<BatchClientBehavior>

Eine Auflistung von BatchClientBehavior Instanzen, die auf die Batch-Dienstanforderung nach CustomBehaviorsangewendet werden.

cancellationToken

CancellationToken

A CancellationToken zum Steuern der Lebensdauer des asynchronen Vorgangs.

Gibt zurück

Task

Ein Task-Element, das den asynchronen Vorgang darstellt.

Hinweise

Der Vorgang zum Ändern der Größe fordert eine Größenänderung des Pools an. Die Anforderung versetzt den Pool in den Zuordnungszustand Resizing . Der Batch-Dienst führt die tatsächliche Größenänderung ohne weitere Clientaktion aus und legt den Zuordnungsstatus nach Abschluss fest Steady .

Sie können die Größe eines Pools nur ändern, wenn er AllocationState lautet Steady. Sie können die Größe von Pools nicht ändern, die für die automatische Skalierung konfiguriert sind (das heißt, die AutoScaleEnabled Eigenschaft des Pools ist true). Wenn Sie die Poolgröße verringern, wählt der Batch-Dienst aus, welche Knoten entfernt werden sollen. Rufen Sie zum Entfernen bestimmter Knoten auf RemoveFromPoolAsync(String, IEnumerable<String>, Nullable<ComputeNodeDeallocationOption>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>, CancellationToken).

Der Vorgang zum Ändern der Größe wird asynchron ausgeführt.