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

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

DownloadCertificateAsync(String, String, CancellationToken)

Origem:: CertificateClient.cs

Origem:: CertificateClient.cs

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

O nome do certificado a ser baixado.

version: String

Versão opcional de um certificado a ser baixado.

cancellationToken: CancellationToken

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

Retornos

Task<Response<X509Certificate2>>

Um X509Certificate2 do certificado especificado.

Exceções

InvalidOperationException

O segredo gerenciado não continha um certificado.

ArgumentException

certificateName está vazio.

ArgumentNullException

certificateName é 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

DownloadCertificateAsync(DownloadCertificateOptions, CancellationToken)

Origem:: CertificateClient.cs

Origem:: CertificateClient.cs

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