PoolOperations.ResizePoolAsync メソッド

定義

名前空間:

Microsoft.Azure.Batch

アセンブリ:

Microsoft.Azure.Batch.dll

パッケージ:

Microsoft.Azure.Batch v16.0.0

指定したプールのサイズを変更します。

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

パラメーター

poolId

String

プールの ID。

targetDedicatedComputeNodes

Nullable<Int32>

プール内の専用コンピューティング ノードの必要な数。 と のtargetDedicatedComputeNodestargetLowPriorityComputeNodes少なくとも 1 つが必要です。

targetLowPriorityComputeNodes

Nullable<Int32>

プール内の優先順位の低いコンピューティング ノードの必要な数。 と のtargetDedicatedComputeNodestargetLowPriorityComputeNodes少なくとも 1 つが必要です。

resizeTimeout

Nullable<TimeSpan>

プールへのコンピューティング ノードの割り当てまたはプールからのコンピューティング ノードの削除のタイムアウト。 この時点以降にプールがターゲット サイズに達していない場合、サイズ変更は停止されます。 既定では 15 分です。

deallocationOption

Nullable<ComputeNodeDeallocationOption>

既に実行されているタスクを処理する方法を指定します。また、プール のサイズが小さくなっている場合に、それらを実行しているノードをプールから削除できるタイミングを指定します。 既定値は、Requeue です。

additionalBehaviors

IEnumerable<BatchClientBehavior>

の後の BatchClientBehavior Batch サービス要求に適用されるインスタンスの CustomBehaviorsコレクション。

cancellationToken

CancellationToken

CancellationToken非同期操作の有効期間を制御するための 。

戻り値

Task

非同期操作を表す Task。

注釈

サイズ変更操作では、プールのサイズ変更が要求されます。 要求により、プール Resizing が割り当て状態になります。 Batch サービスは、クライアントアクションを追加せずに実際のサイズ変更を実行し、完了したら割り当て状態を に Steady 設定します。

プールのサイズは、 の場合AllocationStateSteadyにのみ変更できます。 自動スケーリング用に構成されているプールのサイズを変更することはできません (つまり、 AutoScaleEnabled プールのプロパティは true です)。 プール サイズを小さくすると、Batch サービスによって削除するノードが選択されます。 特定のノードを削除するには、 を呼び出します RemoveFromPoolAsync(String, IEnumerable<String>, Nullable<ComputeNodeDeallocationOption>, Nullable<TimeSpan>, IEnumerable<BatchClientBehavior>, CancellationToken)。

サイズ変更操作は非同期的に実行されます。