IComputeNodeOperations.DeallocateWithHttpMessagesAsync Method

Definition

Deallocates the specified Compute Node.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationHeaderResponse<Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateHeaders>> DeallocateWithHttpMessagesAsync (string poolId, string nodeId, Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateOption? nodeDeallocateOption = default, Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateOptions computeNodeDeallocateOptions = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DeallocateWithHttpMessagesAsync : string * string * Nullable<Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateOption> * Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateOptions * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationHeaderResponse<Microsoft.Azure.Batch.Protocol.Models.ComputeNodeDeallocateHeaders>>
Public Function DeallocateWithHttpMessagesAsync (poolId As String, nodeId As String, Optional nodeDeallocateOption As Nullable(Of ComputeNodeDeallocateOption) = Nothing, Optional computeNodeDeallocateOptions As ComputeNodeDeallocateOptions = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationHeaderResponse(Of ComputeNodeDeallocateHeaders))

Parameters

poolId
String

The ID of the Pool that contains the Compute Node.

nodeId
String

The ID of the Compute Node that you want to deallocate.

nodeDeallocateOption
Nullable<ComputeNodeDeallocateOption>

When to deallocate the Compute Node and what to do with currently running Tasks. The default value is requeue. Possible values include: 'requeue', 'terminate', 'taskCompletion', 'retainedData'

computeNodeDeallocateOptions
ComputeNodeDeallocateOptions

Additional parameters for the operation

customHeaders
Dictionary<String,List<String>>

The headers that will be added to request.

cancellationToken
CancellationToken

The cancellation token.

Returns

Exceptions

Thrown when the operation returned an invalid status code

Thrown when a required parameter is null

Remarks

You can deallocate a Compute Node only if it is in an idle or running state.

Applies to