CertificateClient.DownloadCertificate Método

Referência

Definição

Namespace:: Azure.Security.KeyVault.Certificates

Assembly:: Azure.Security.KeyVault.Certificates.dll

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

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

DownloadCertificate(DownloadCertificateOptions, CancellationToken)	Cria um X509Certificate2 do certificado especificado.
DownloadCertificate(String, String, CancellationToken)	Cria um X509Certificate2 do certificado especificado.

DownloadCertificate(DownloadCertificateOptions, CancellationToken)

Origem:: CertificateClient.cs

Origem:: CertificateClient.cs

Cria um X509Certificate2 do 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

Opções para baixar e criar um X509Certificate2.

cancellationToken: CancellationToken

Um CancellationToken que controla o tempo de vida da solicitação.

Retornos

Response<X509Certificate2>

Um X509Certificate2 do certificado especificado.

Exceções

ArgumentNullException

options é nulo.

InvalidDataException

O segredo gerenciado não continha um certificado.

NotSupportedException

Não CertificateContentType há suporte para o .

PlatformNotSupportedException

Não é possível criar um X509Certificate2 nesta plataforma.

RequestFailedException

A solicitação falhou. Consulte ErrorCode e a mensagem de exceção para obter detalhes.

Comentários

Como Cer contém apenas a chave pública, esse método tenta baixar o segredo gerenciado que contém o certificado completo. Se você não tiver permissões para obter o segredo, RequestFailedException será lançado com uma resposta de erro apropriada. Se você quiser um X509Certificate2 com apenas a chave pública, instancie-o passando apenas a Cer propriedade . Essa operação requer as permissões certificates/get e secrets/get.

Aplica-se a

DownloadCertificate(String, String, CancellationToken)

Origem:: CertificateClient.cs

Origem:: CertificateClient.cs

Cria um X509Certificate2 do 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)