KeyClient.RestoreKeyBackupAsync(Byte[], CancellationToken) Método

Definição

Namespace:

Azure.Security.KeyVault.Keys

Assembly:

Azure.Security.KeyVault.Keys.dll

Pacote:

Azure.Security.KeyVault.Keys v4.6.0

Origem:

KeyClient.cs

Restaura uma chave de backup em um cofre.

public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Keys.KeyVaultKey>> RestoreKeyBackupAsync (byte[] backup, System.Threading.CancellationToken cancellationToken = default);

abstract member RestoreKeyBackupAsync : byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Keys.KeyVaultKey>>
override this.RestoreKeyBackupAsync : byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Security.KeyVault.Keys.KeyVaultKey>>

Public Overridable Function RestoreKeyBackupAsync (backup As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of KeyVaultKey))

Parâmetros

backup

Byte[]

O blob de backup associado a uma chave.

cancellationToken

CancellationToken

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

Retornos

Task<Response<KeyVaultKey>>

Exceções

ArgumentException

backup é uma cadeia de caracteres vazia.

ArgumentNullException

backup é nulo.

RequestFailedException

O servidor retornou um erro. Consulte Message para obter detalhes retornados do servidor.

Comentários

Importa uma chave de backup anteriormente para o Azure Key Vault, restaurando a chave, seu identificador de chave, atributos e políticas de controle de acesso. A operação RESTORE pode ser usada para importar uma chave de backup anterior. As versões individuais de uma chave não podem ser restauradas. A chave é restaurada integralmente com o mesmo nome da chave que tinha quando foi feito o backup. Se o nome da chave não estiver disponível no Cofre de Chaves de destino, a operação RESTORE será rejeitada. Embora o nome da chave seja mantido durante a restauração, o identificador de chave final será alterado se a chave for restaurada em um cofre diferente. A restauração irá restaurar todas as versões e preservar os identificadores de versão. A operação RESTORE está sujeita a restrições de segurança: o Key Vault de destino deve pertencer à mesma Assinatura do Microsoft Azure que o Key Vault de origem O usuário deve ter permissão RESTORE no Key Vault de destino. Essa operação requer a permissão de restauração/chaves.