CertificateClient.DownloadCertificateAsync 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.
Surcharges
DownloadCertificateAsync(String, String, CancellationToken) |
Crée un X509Certificate2 à partir du certificat spécifié. |
DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken) |
Crée un X509Certificate2 à partir du certificat spécifié. |
DownloadCertificateAsync(String, String, CancellationToken)
- Source:
- CertificateClient.cs
- Source:
- CertificateClient.cs
Crée un X509Certificate2 à partir du certificat spécifié.
public virtual System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>> DownloadCertificateAsync (string certificateName, string version = default, System.Threading.CancellationToken cancellationToken = default);
abstract member DownloadCertificateAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
override this.DownloadCertificateAsync : string * string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
Public Overridable Function DownloadCertificateAsync (certificateName As String, Optional version As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of X509Certificate2))
Paramètres
- certificateName
- String
Nom du certificat à télécharger.
- version
- String
Version facultative d’un certificat à télécharger.
- cancellationToken
- CancellationToken
CancellationToken Contrôle de la durée de vie de la requête.
Retours
X509Certificate2 à partir du certificat spécifié.
Exceptions
Le secret managé ne contenait pas de certificat.
certificateName
est vide.
certificateName
a la valeur null.
Le secret managé ne contenait pas de certificat.
n’est CertificateContentType pas pris en charge.
Impossible de créer un X509Certificate2 sur cette plateforme.
La demande a échoué. Pour plus d’informations, consultez ErrorCode et le message d’exception.
Remarques
Étant donné que Cer contient uniquement la clé publique, cette méthode tente de télécharger le secret managé qui contient le certificat complet. Si vous ne disposez pas des autorisations nécessaires pour obtenir le secret, RequestFailedException sera levée avec une réponse d’erreur appropriée. Si vous voulez un X509Certificate2 avec uniquement la clé publique, instanciez-le en passant uniquement la Cer propriété. Cette opération nécessite les autorisations certificats/obtenir et secrets/obtenir.
S’applique à
DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)
- Source:
- CertificateClient.cs
- Source:
- CertificateClient.cs
Crée un X509Certificate2 à partir du certificat spécifié.
public virtual System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>> DownloadCertificateAsync (Azure.Security.KeyVault.Certificates.DownloadCertificateOptions options, System.Threading.CancellationToken cancellationToken = default);
abstract member DownloadCertificateAsync : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
override this.DownloadCertificateAsync : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>>
Public Overridable Function DownloadCertificateAsync (options As DownloadCertificateOptions, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of X509Certificate2))
Paramètres
- options
- DownloadCertificateOptions
Options supplémentaires pour télécharger et créer un X509Certificate2.
- cancellationToken
- CancellationToken
CancellationToken Contrôle de la durée de vie de la requête.
Retours
X509Certificate2 à partir du certificat spécifié.
Exceptions
options
a la valeur null.
Le secret managé ne contenait pas de certificat.
n’est CertificateContentType pas pris en charge.
Impossible de créer un X509Certificate2 sur cette plateforme.
La demande a échoué. Pour plus d’informations, consultez ErrorCode et le message d’exception.
Remarques
Étant donné que Cer contient uniquement la clé publique, cette méthode tente de télécharger le secret managé qui contient le certificat complet. Si vous ne disposez pas des autorisations nécessaires pour obtenir le secret, RequestFailedException sera levée avec une réponse d’erreur appropriée. Si vous voulez un X509Certificate2 avec uniquement la clé publique, instanciez-le en passant uniquement la Cer propriété. Cette opération nécessite les autorisations certificats/obtenir et secrets/obtenir.
S’applique à
Azure SDK for .NET