Freigeben über


KeyClient.RestoreKeyBackupAsync(Byte[], CancellationToken) Methode

Definition

Stellt einen gesicherten Schlüssel in einem Tresor wieder her.

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))

Parameter

backup
Byte[]

Das Sicherungsblob, das einem Schlüssel zugeordnet ist.

cancellationToken
CancellationToken

Ein CancellationToken , der die Anforderungsdauer steuert.

Gibt zurück

Ausnahmen

backup ist eine leere Zeichenfolge.

backup ist NULL.

Der Server hat einen Fehler zurückgegeben. Details, die vom Server zurückgegeben werden, finden Sie Message unter.

Hinweise

Importiert einen zuvor gesicherten Schlüssel in Azure Key Vault, wobei der Schlüssel, seine Schlüsselbezeichner, Attribute und Zugriffssteuerungsrichtlinien wiederhergestellt werden. Der RESTORE-Vorgang kann verwendet werden, um einen zuvor gesicherten Schlüssel zu importieren. Einzelne Versionen eines Schlüssels können nicht wiederhergestellt werden. Der Schlüssel wird in seiner Gesamtheit mit demselben Schlüsselnamen wiederhergestellt, den er bei der Sicherung hatte. Wenn der Name des Schlüssels im Zielschlüsseltresor nicht verfügbar ist, wird der RESTORE-Vorgang abgelehnt. Während der Name des Schlüssels bei der Wiederherstellung beibehalten wird, ändert sich der endgültige Schlüsselbezeichner, wenn der Schlüssel in einem anderen Tresor wiederhergestellt wird. RESTORE stellt alle Versionen wieder her und erhält die Versionsbezeichner. Der RESTORE-Vorgang unterliegt Sicherheitseinschränkungen: Die Ziel-Key Vault muss sich im Besitz desselben Microsoft Azure-Abonnements befinden wie das Quell-Key Vault Der Benutzer muss über die RESTORE-Berechtigung in der Ziel-Key Vault verfügen. Für diesen Vorgang ist die Schlüssel-/Wiederherstellungsberechtigung erforderlich.

Gilt für: