CertificateClient.DownloadCertificateAsync Método

Referencia

Definición

Espacio de nombres:: Azure.Security.KeyVault.Certificates

Ensamblado:: Azure.Security.KeyVault.Certificates.dll

Paquete:: Azure.Security.KeyVault.Certificates v4.6.0

Paquete:: Azure.Security.KeyVault.Certificates v4.6.0-beta.2

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

DownloadCertificateAsync(String, String, CancellationToken)	Crea un a X509Certificate2 partir del certificado especificado.
DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)	Crea un a X509Certificate2 partir del certificado especificado.

DownloadCertificateAsync(String, String, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

Crea un a X509Certificate2 partir del certificado especificado.

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))

Parámetros

certificateName: String

Nombre del certificado que se va a descargar.

version: String

Versión opcional de un certificado que se va a descargar.

cancellationToken: CancellationToken

Control CancellationToken de la duración de la solicitud.

Devoluciones

Task<Response<X509Certificate2>>

a X509Certificate2 partir del certificado especificado.

Excepciones

InvalidOperationException

El secreto administrado no contenía un certificado.

ArgumentException

certificateName está vacía.

ArgumentNullException

certificateName es null.

InvalidDataException

El secreto administrado no contenía un certificado.

NotSupportedException

CertificateContentType No se admite .

PlatformNotSupportedException

No se puede crear en X509Certificate2 esta plataforma.

RequestFailedException

Error en la solicitud. Consulte ErrorCode y el mensaje de excepción para obtener más información.

Comentarios

Dado que Cer solo contiene la clave pública, este método intenta descargar el secreto administrado que contiene el certificado completo. Si no tiene permisos para obtener el secreto, RequestFailedException se producirá una respuesta de error adecuada. Si desea un X509Certificate2 con solo la clave pública, cree una instancia de él pasando solo la Cer propiedad . Esta operación requiere los permisos certificates/get y secrets/get.

Se aplica a

DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

Crea un a X509Certificate2 partir del certificado especificado.

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))