CertificateOperations.DeleteCertificateAsync メソッド

定義

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

パラメーター

thumbprintAlgorithm
String

パラメーターの派生に使用される thumbprint アルゴリズム。 これは sha1 である必要があります。

thumbprint
String

削除する証明書の拇印。

additionalBehaviors
IEnumerable<BatchClientBehavior>

の後の BatchClientBehavior Batch サービス要求に適用されるインスタンスの CustomBehaviorsコレクション。

cancellationToken
CancellationToken

CancellationToken非同期操作の有効期間を制御するための 。

戻り値

非同期操作を表す Task

注釈

削除操作では、証明書の削除が要求されます。 要求によって証明書が状態になります Deleting 。 Batch サービスは、クライアント操作を行わずに実際の証明書の削除を実行します。

リソース (プールまたはコンピューティング ノード) で証明書が使用されている場合、証明書を削除することはできません。 したがって、証明書を削除する前に、次の点を確認する必要があります。

  • 証明書はどのプールにも関連付けされていません。
  • 証明書はどのコンピューティング ノードにもインストールされていません。 (プールから証明書を削除した場合でも、再起動するまで、そのプール内の既存のコンピューティング ノードから証明書は削除されません)。

使用中の証明書を削除しようとすると、削除は失敗します。 証明書の状態が に DeleteFailed変わります。 証明書を引き続き使用する場合は、 を使用 CancelDeleteCertificateAsync(String, String, IEnumerable<BatchClientBehavior>, CancellationToken) して状態を [アクティブ] に戻すことができます。

削除操作は非同期的に実行されます。

適用対象