Compartir a través de


KeyClient.BackupKey(String, CancellationToken) Método

Definición

Solicita que se descargue una copia de seguridad de la clave especificada en el cliente.

public virtual Azure.Response<byte[]> BackupKey (string name, System.Threading.CancellationToken cancellationToken = default);
abstract member BackupKey : string * System.Threading.CancellationToken -> Azure.Response<byte[]>
override this.BackupKey : string * System.Threading.CancellationToken -> Azure.Response<byte[]>
Public Overridable Function BackupKey (name As String, Optional cancellationToken As CancellationToken = Nothing) As Response(Of Byte())

Parámetros

name
String

El nombre de la clave.

cancellationToken
CancellationToken

Control CancellationToken de la duración de la solicitud.

Devoluciones

Excepciones

name es una cadena vacía.

name es null.

El servidor devolvió un error. Consulte Message para obtener más información devuelta desde el servidor.

Comentarios

La operación De copia de seguridad de claves exporta una clave de Azure Key Vault en un formulario protegido. Tenga en cuenta que esta operación NO devuelve la clave real en un formulario que se puede usar fuera del sistema de Azure Key Vault, la clave devuelta está protegida en un HSM de Azure Key Vault o en Azure Key Vault mismo. El propósito de esta operación es permitir a un cliente generar mediante GENERATE una clave en una instancia del Almacén de claves de Azure, hacer una copia de seguridad de la clave mediante BACKUP y, a continuación, restaurarla mediante RESTORE en otra instancia del Almacén de claves de Azure. La operación BACKUP puede utilizarse para exportar, en un formato protegido, cualquier tipo de clave del Almacén de claves de Azure. No se puede hacer una copia de seguridad de diferentes versiones de una clave. Las operaciones BACKUP / RESTORE pueden realizarse solo dentro de los límites geográficos; lo que significa que no se puede restaurar una operación BACKUP de un área geográfica en otra área geográfica. Por ejemplo, no se puede restaurar una copia de seguridad de la zona geográfica de Estados Unidos en un área geográfica de la UE. Esta operación requiere el permiso de clave/copia de seguridad.

Se aplica a