KeyVaultClient.BackupKeyWithHttpMessagesAsync Método

Definição

Namespace:

Microsoft.Azure.KeyVault

Assembly:

Microsoft.Azure.KeyVault.dll

Pacote:

Microsoft.Azure.KeyVault v3.0.5

Origem:

KeyVaultClient.cs

Solicita que um backup da chave especificada seja baixado para o cliente.

public System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.BackupKeyResult>> BackupKeyWithHttpMessagesAsync (string vaultBaseUrl, string keyName, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member BackupKeyWithHttpMessagesAsync : string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.BackupKeyResult>>
override this.BackupKeyWithHttpMessagesAsync : string * string * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.KeyVault.Models.BackupKeyResult>>

Public Function BackupKeyWithHttpMessagesAsync (vaultBaseUrl As String, keyName As String, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of BackupKeyResult))

Parâmetros

vaultBaseUrl

String

O nome do cofre, por exemplo https://myvault.vault.azure.net, .

keyName

String

O nome da chave.

customHeaders

Dictionary<String,List<String>>

Cabeçalhos que serão adicionados à solicitação.

cancellationToken

CancellationToken

O token de cancelamento.

Retornos

Task<AzureOperationResponse<BackupKeyResult>>

Implementações

BackupKeyWithHttpMessagesAsync(String, String, Dictionary<String,List<String>>, CancellationToken)

Exceções

KeyVaultErrorException

Gerada quando a operação retornou um código de status inválido

SerializationException

Gerada quando não é possível desserializar a resposta

ValidationException

Gerado quando um parâmetro necessário é nulo

ArgumentNullException

Gerado quando um parâmetro necessário é nulo

Comentários

A operação de Backup de Chave exporta uma chave do Azure Key Vault em um formulário protegido. Observe que essa operação NÃO retorna o material de chaves em um formulário que pode ser usado fora do sistema do Cofre de Chaves do Azure, o material de chaves retornado é protegido para um HSM do Cofre de Chaves do Azure ou para o Cofre de Chaves do Azure em si. A intenção dessa operação é permitir que um cliente GERE uma chave em uma instância do Cofre de Chaves do Azure, FAÇA BACKUP da chave e, em seguida, RESTAURE a chave em outra instância do Cofre de Chaves do Azure. A operação BACKUP pode ser usada para exportar, de forma protegida, qualquer tipo de chave do Cofre de Chaves do Azure. Não é possível fazer backup das versões individuais de uma chave. A operação BACKUP/RESTORE pode ser executada apenas dentro dos limites geográficos. Isso significa que um BACKUP de uma área geográfica não pode ser restaurado para outra área geográfica. Por exemplo, um backup da área geográfica dos EUA não pode ser restaurado em uma área geográfica da UE. Essa operação requer a permissão de chave/backup.