KeyVaultClient.BackupKeyWithHttpMessagesAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.KeyVault

Assembly:

Microsoft.Azure.KeyVault.dll

Paquet:

Microsoft.Azure.KeyVault v3.0.5

Source:

KeyVaultClient.cs

Demande qu’une sauvegarde de la clé spécifiée soit téléchargée sur le client.

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

Paramètres

vaultBaseUrl

String

Nom du coffre, par exemple https://myvault.vault.azure.net.

keyName

String

Nom de la clé.

customHeaders

Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la requête.

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<AzureOperationResponse<BackupKeyResult>>

Implémente

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

Exceptions

KeyVaultErrorException

Levée lorsque l’opération a retourné un code status non valide

SerializationException

Levée lorsque la réponse ne peut pas être désérialisée

ValidationException

Levée lorsqu’un paramètre requis a la valeur Null

ArgumentNullException

Levée lorsqu’un paramètre requis a la valeur Null

Remarques

L’opération De sauvegarde de clé exporte une clé à partir d’Azure Key Vault sous une forme protégée. Notez que cette opération ne renvoie PAS de matériel de clé sous une forme utilisable en dehors du système d’Azure Key Vault. Le matériel de clé renvoyé est soit protégé dans un module de sécurité matériel (HSM) pour Azure Key Vault, soit dans Azure Key Vault lui-même. L'objectif de cette opération consiste à permettre à un client de générer (GENERATE) une clé dans une instance de coffre de clés Azure, de sauvegarder (BACKUP) la clé, puis de la restaurer (RESTORE) dans une autre instance de coffre de clés Azure. L'opération BACKUP peut servir à exporter, sous forme protégée, n'importe quel type de clé à partir du coffre de clés Azure. Les versions individuelles d'une clé ne peuvent pas être sauvegardées. Les opérations BACKUP/RESTORE peuvent être effectuées uniquement dans certaines limites géographiques. Cela signifie qu'une sauvegarde à partir d'une zone géographique ne peut pas être restaurée dans une autre. Par exemple, une sauvegarde réalisée dans la zone géographique US ne peut pas être restaurée dans une zone géographique UE. Cette opération nécessite l’autorisation clé/sauvegarde.