IPoolOperations.DeleteWithHttpMessagesAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Supprime un pool du compte spécifié.
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))
Paramètres
- poolId
- String
ID du pool à supprimer.
- poolDeleteOptions
- PoolDeleteOptions
Paramètres supplémentaires pour l’opération
- customHeaders
- Dictionary<String,List<String>>
En-têtes qui seront ajoutés à la demande.
- cancellationToken
- CancellationToken
Jeton d'annulation.
Retours
Exceptions
Levée lorsque l’opération a retourné un code status non valide
Levée lorsqu’un paramètre requis a la valeur Null
Remarques
Lorsque vous demandez la suppression d’un pool, les actions suivantes se produisent : l’état du pool est défini sur suppression ; toute opération de redimensionnement en cours sur le pool est arrêtée ; le service Batch commence à redimensionner le pool sur zéro nœud de calcul ; toutes les tâches en cours d’exécution sur des nœuds de calcul existants sont arrêtées et mises en file d’attente (comme si une opération de redimensionnement du pool avait été demandée avec l’option de mise en file d’attente par défaut) ; enfin, le pool est supprimé du système. Étant donné que les tâches en cours d’exécution sont mises en file d’attente, l’utilisateur peut réexécuter ces tâches en mettant à jour son travail pour cibler un autre pool. Les tâches peuvent ensuite s’exécuter sur le nouveau pool. Si vous souhaitez remplacer le comportement de mise en file d’attente, vous devez appeler le pool de redimensionnement explicitement pour réduire la taille du pool à zéro avant de supprimer le pool. Si vous appelez une API Update, Patch ou Delete sur un pool à l’état de suppression, elle échoue avec http status code 409 avec le code d’erreur PoolBeingDeleted.
S’applique à
Azure SDK for .NET