KeyClient.BackupKeyAsync(String, CancellationToken) Método

Definición

Espacio de nombres:

Azure.Security.KeyVault.Keys

Ensamblado:

Azure.Security.KeyVault.Keys.dll

Paquete:

Azure.Security.KeyVault.Keys v4.6.0

Source:

KeyClient.cs

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

public virtual System.Threading.Tasks.Task<Azure.Response<byte[]>> BackupKeyAsync (string name, System.Threading.CancellationToken cancellationToken = default);

abstract member BackupKeyAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<byte[]>>
override this.BackupKeyAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<byte[]>>

Public Overridable Function BackupKeyAsync (name As String, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of Byte()))

Parámetros

name

String

El nombre de la clave.

cancellationToken

CancellationToken

Control CancellationToken de la duración de la solicitud.

Devoluciones

Task<Response<Byte[]>>

Excepciones

ArgumentException

name es una cadena vacía.

ArgumentNullException

name es null.

RequestFailedException

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.