CertificateClient.DownloadCertificate 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

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

DownloadCertificate(DownloadCertificateOptions, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

Crea un a X509Certificate2 partir del certificado especificado.

public virtual Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2> DownloadCertificate (Azure.Security.KeyVault.Certificates.DownloadCertificateOptions options, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificate : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>
override this.DownloadCertificate : Azure.Security.KeyVault.Certificates.DownloadCertificateOptions * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>

Public Overridable Function DownloadCertificate (options As DownloadCertificateOptions, Optional cancellationToken As CancellationToken = Nothing) As Response(Of X509Certificate2)

Parámetros

options: DownloadCertificateOptions

Opciones para descargar y crear un X509Certificate2.

cancellationToken: CancellationToken

Control CancellationToken de la duración de la solicitud.

Devoluciones

Response<X509Certificate2>

a X509Certificate2 partir del certificado especificado.

Excepciones

ArgumentNullException

options 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

DownloadCertificate(String, String, CancellationToken)

Source:: CertificateClient.cs

Source:: CertificateClient.cs

Crea un a X509Certificate2 partir del certificado especificado.

public virtual Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2> DownloadCertificate (string certificateName, string version = default, System.Threading.CancellationToken cancellationToken = default);

abstract member DownloadCertificate : string * string * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>
override this.DownloadCertificate : string * string * System.Threading.CancellationToken -> Azure.Response<System.Security.Cryptography.X509Certificates.X509Certificate2>

Public Overridable Function DownloadCertificate (certificateName As String, Optional version As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Response(Of X509Certificate2)