CertificateOperations.DeleteCertificateAsync Methode

Definition

Namespace:

Microsoft.Azure.Batch

Assembly:

Microsoft.Azure.Batch.dll

Paket:

Microsoft.Azure.Batch v16.2.0

Quelle:

CertificateOperations.cs

Löscht das Zertifikat aus dem Batch-Konto.

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

Parameter

thumbprintAlgorithm

String

Der Algorithmus, der zum Ableiten des thumbprint Parameters verwendet wird. Dies muss sha1 sein.

thumbprint

String

Der Fingerabdruck des zu löschenden Zertifikats.

additionalBehaviors

IEnumerable<BatchClientBehavior>

Eine Auflistung von BatchClientBehavior Instanzen, die auf die Batch-Dienstanforderung nach CustomBehaviorsangewendet werden.

cancellationToken

CancellationToken

A CancellationToken zum Steuern der Lebensdauer des asynchronen Vorgangs.

Gibt zurück

Task

Ein Task-Element, das den asynchronen Vorgang darstellt.

Hinweise

Der Löschvorgang fordert das Löschen des Zertifikats an. Die Anforderung versetzt das Zertifikat in den Deleting Zustand. Der Batch-Dienst führt das tatsächliche Löschen des Zertifikats ohne weitere Clientaktion aus.

Sie können ein Zertifikat nicht löschen, wenn es von einer Ressource (Pool oder Computeknoten) verwendet wird. Bevor Sie ein Zertifikat löschen können, müssen Sie folgendes sicherstellen:

• Das Zertifikat ist keinem Pool zugeordnet.
• Das Zertifikat ist auf keinem Computeknoten installiert. (Selbst wenn Sie ein Zertifikat aus einem Pool entfernen, wird es nicht von vorhandenen Computeknoten in diesem Pool entfernt, bis sie neu gestartet werden.)

Wenn Sie versuchen, ein verwendetes Zertifikat zu löschen, schlägt der Löschvorgang fehl. Der Zertifikatstatus ändert sich in DeleteFailed. Sie können verwendenCancelDeleteCertificateAsync(String, String, IEnumerable<BatchClientBehavior>, CancellationToken), um die status wieder auf Aktiv festzulegen, wenn Sie das Zertifikat weiterhin verwenden möchten.

Der Löschvorgang wird asynchron ausgeführt.