IPoolOperations.DeleteWithHttpMessagesAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Batch.Protocol

Ensamblado:

Microsoft.Azure.Batch.dll

Paquete:

Microsoft.Azure.Batch v16.2.0

Source:

IPoolOperations.cs

Elimina un grupo de la cuenta especificada.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationHeaderResponse<Microsoft.Azure.Batch.Protocol.Models.PoolDeleteHeaders>> DeleteWithHttpMessagesAsync (string poolId, Microsoft.Azure.Batch.Protocol.Models.PoolDeleteOptions poolDeleteOptions = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DeleteWithHttpMessagesAsync : string * Microsoft.Azure.Batch.Protocol.Models.PoolDeleteOptions * 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.PoolDeleteHeaders>>

Public Function DeleteWithHttpMessagesAsync (poolId As String, Optional poolDeleteOptions As PoolDeleteOptions = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationHeaderResponse(Of PoolDeleteHeaders))

Parámetros

poolId

String

Identificador del grupo que se va a eliminar.

poolDeleteOptions

PoolDeleteOptions

Parámetros adicionales para la operación

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<AzureOperationHeaderResponse<PoolDeleteHeaders>>

Excepciones

BatchErrorException

Se produce cuando la operación devolvió un código de estado no válido

ValidationException

Se produce cuando un parámetro obligatorio es NULL

Comentarios

Cuando se solicita que se elimine un grupo, se producen las siguientes acciones: el estado del grupo se establece en eliminar; se detiene cualquier operación de cambio de tamaño en curso en el grupo; el servicio Batch comienza a cambiar el tamaño del grupo a cero nodos de proceso; Todas las tareas que se ejecutan en nodos de ejecución existentes se finalizan y se vuelven a poner en cola (como si se hubiera solicitado una operación de grupo de cambio de tamaño con la opción de requeue predeterminada); por último, el grupo se quita del sistema. Dado que las tareas en ejecución se vuelven a poner en cola, el usuario puede volver a ejecutar estas tareas actualizando su trabajo para tener como destino un grupo diferente. A continuación, las tareas se pueden ejecutar en el nuevo grupo. Si desea invalidar el comportamiento de la puesta en cola, debe llamar al grupo de cambio de tamaño explícitamente para reducir el grupo a un tamaño cero antes de eliminar el grupo. Si llama a una API Update, Patch o Delete en un grupo en el estado de eliminación, se producirá un error con el código de estado HTTP 409 con el código de error PoolBeingDeleted.