CertificateOperations.DeleteCertificateAsync Méthode

Définition

Supprime le certificat du compte Batch.

public System.Threading.Tasks.Task DeleteCertificateAsync (string thumbprintAlgorithm, string thumbprint, System.Collections.Generic.IEnumerable<Microsoft.Azure.Batch.BatchClientBehavior> additionalBehaviors = default, System.Threading.CancellationToken cancellationToken = default);
member this.DeleteCertificateAsync : string * string * seq<Microsoft.Azure.Batch.BatchClientBehavior> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function DeleteCertificateAsync (thumbprintAlgorithm As String, thumbprint As String, Optional additionalBehaviors As IEnumerable(Of BatchClientBehavior) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task

Paramètres

thumbprintAlgorithm
String

Algorithme utilisé pour dériver le thumbprint paramètre. Il doit s’agir de sha1.

thumbprint
String

Empreinte numérique du certificat à supprimer.

additionalBehaviors
IEnumerable<BatchClientBehavior>

Collection d’instances BatchClientBehavior appliquées à la demande de service Batch après le CustomBehaviors.

cancellationToken
CancellationToken

CancellationToken pour contrôler la durée de vie de l’opération asynchrone.

Retours

Task qui représente l'opération asynchrone.

Remarques

L’opération de suppression demande que le certificat soit supprimé. La demande place le certificat dans l’état Deleting . Le service Batch effectue la suppression réelle du certificat sans aucune autre action du client.

Vous ne pouvez pas supprimer un certificat si une ressource (pool ou nœud de calcul) l’utilise. Avant de pouvoir supprimer un certificat, vous devez donc vous assurer que :

  • Le certificat n’est associé à aucun pool.
  • Le certificat n’est installé sur aucun nœud de calcul. (Même si vous supprimez un certificat d’un pool, il n’est pas supprimé des nœuds de calcul existants dans ce pool tant qu’ils ne redémarrent pas.)

Si vous essayez de supprimer un certificat en cours d’utilisation, la suppression échoue. L’état du certificat devient DeleteFailed. Vous pouvez utiliser CancelDeleteCertificateAsync(String, String, IEnumerable<BatchClientBehavior>, CancellationToken) pour définir le status sur Actif si vous décidez de continuer à utiliser le certificat.

L’opération de suppression s’exécute de manière asynchrone.

S’applique à