Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # DescribeBackupVault Renvoie les métadonnées relatives à un coffre-fort de sauvegarde spécifié par son nom. ## Syntaxe de la demande ``` GET /backup-vaults/backupVaultName?backupVaultAccountId=BackupVaultAccountId HTTP/1.1 ``` ## Paramètres de demande URI La demande utilise les paramètres URI suivants. ** [BackupVaultAccountId](#API_DescribeBackupVault_RequestSyntax) ** ID de compte du coffre-fort de sauvegarde spécifié. ** [backupVaultName](#API_DescribeBackupVault_RequestSyntax) ** Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région AWS dans laquelle ils sont créés. Obligatoire : oui ## Corps de la demande La demande n’a pas de corps de requête. ## Syntaxe de la réponse ``` HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number, "CreatorRequestId": "string", "EncryptionKeyArn": "string", "EncryptionKeyType": "string", "LatestMpaApprovalTeamUpdate": { "ExpiryDate": number, "InitiationDate": number, "MpaSessionArn": "string", "Status": "string", "StatusMessage": "string" }, "LockDate": number, "Locked": boolean, "MaxRetentionDays": number, "MinRetentionDays": number, "MpaApprovalTeamArn": "string", "MpaSessionArn": "string", "NumberOfRecoveryPoints": number, "SourceBackupVaultArn": "string", "VaultState": "string", "VaultType": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [BackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** Amazon Resource Name (ARN) qui identifie de façon unique un coffre-fort de sauvegarde ; par exemple, `arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault`. Type : Chaîne ** [BackupVaultName](#API_DescribeBackupVault_ResponseSyntax) ** Le nom d'un conteneur logique où les sauvegardes sont stockées. Les coffres-forts de sauvegarde sont identifiés par des noms spécifiques pour le compte utilisé pour les créer et la région dans laquelle ils sont créés. Type : Chaîne ** [CreationDate](#API_DescribeBackupVault_ResponseSyntax) ** Date et heure de création d'un coffre-fort de sauvegarde, au format Unix et au format UTC (temps universel coordonné). La valeur de `CreationDate` est précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s. Type : Timestamp ** [CreatorRequestId](#API_DescribeBackupVault_ResponseSyntax) ** Une chaîne unique qui identifie la demande et permet de réessayer les demandes ayant échoué sans risque d'exécuter l'opération deux fois. Ce paramètre est facultatif. S'il est utilisé, ce paramètre doit contenir de 1 à 50 caractères alphanumériques ou « -\$1. » caractères. Type : Chaîne ** [EncryptionKeyArn](#API_DescribeBackupVault_ResponseSyntax) ** Chiffrement côté serveur utilisé pour protéger vos sauvegardes ; par exemple, `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`. Type : Chaîne ** [EncryptionKeyType](#API_DescribeBackupVault_ResponseSyntax) ** Type de clé de chiffrement utilisée pour le coffre de sauvegarde. Les valeurs valides sont CUSTOMER\$1MANAGED\$1KMS\$1KEY pour les clés gérées par le client ou \$1OWNED\$1KMS\$1KEY pour les clés détenues par le client. AWS AWS Type : Chaîne Valeurs valides : `AWS_OWNED_KMS_KEY | CUSTOMER_MANAGED_KMS_KEY` ** [LatestMpaApprovalTeamUpdate](#API_DescribeBackupVault_ResponseSyntax) ** Informations sur la dernière mise à jour de l'association de l'équipe d'approbation MPA pour ce coffre de sauvegarde. Type : objet [LatestMpaApprovalTeamUpdate](API_LatestMpaApprovalTeamUpdate.md) ** [LockDate](#API_DescribeBackupVault_ResponseSyntax) ** Date et heure auxquelles la configuration de AWS Backup Vault Lock ne peut pas être modifiée ou supprimée. Si vous avez appliqué Vault Lock à votre coffre-fort sans spécifier de date de verrouillage, vous pouvez modifier les paramètres de Vault Lock ou supprimer complètement Vault Lock du coffre-fort à tout moment. Cette valeur est au format Unix, en temps universel coordonné (UTC) et précise en millisecondes. Par exemple, la valeur 1516925490,087 représente le vendredi 26 janvier 2018 à 00 h 11 m 30,087 s. Type : Timestamp ** [Locked](#API_DescribeBackupVault_ResponseSyntax) ** Un booléen qui indique si AWS Backup Vault Lock protège actuellement le coffre-fort de sauvegarde. `True`signifie que Vault Lock entraîne l'échec des opérations de suppression ou de mise à jour sur les points de récupération stockés dans le coffre-fort. Type : Boolean ** [MaxRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** Le paramètre AWS Backup Vault Lock qui spécifie la période de rétention maximale pendant laquelle le coffre-fort conserve ses points de récupération. Si ce paramètre n'est pas spécifié, Vault Lock n'applique pas de période de rétention maximale sur les points de récupération dans le coffre-fort (permettant un stockage indéfini). S'il est spécifié, toute tâche de sauvegarde ou de copie vers le coffre-fort doit avoir une politique de cycle de vie avec une période de rétention égale ou inférieure à la période de rétention maximale. Si la période de conservation de la tâche est plus longue que cette période de conservation maximale, la tâche de sauvegarde ou de copie du coffre-fort échoue, et vous devez soit modifier vos paramètres de cycle de vie, soit utiliser un autre coffre-fort. Les points de récupération déjà stockés dans le coffre-fort avant Vault Lock ne sont pas affectés. Type : Long ** [MinRetentionDays](#API_DescribeBackupVault_ResponseSyntax) ** Le paramètre AWS Backup Vault Lock qui spécifie la période de rétention minimale pendant laquelle le coffre-fort conserve ses points de récupération. Si ce paramètre n'est pas spécifié, le verrouillage du coffre-fort n'appliquera pas de période de conservation minimale. S'il est spécifié, toute tâche de sauvegarde ou de copie vers le coffre-fort doit avoir une politique de cycle de vie avec une période de rétention égale ou supérieure à la période de rétention minimale. Si la période de rétention de la tâche est plus courte que cette période de rétention minimale, la tâche de sauvegarde ou de copie du coffre-fort échoue et vous devez soit modifier vos paramètres de cycle de vie, soit utiliser un autre coffre-fort. Les points de récupération déjà stockés dans le coffre-fort avant Vault Lock ne sont pas affectés. Type : Long ** [MpaApprovalTeamArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN de l'équipe d'approbation MPA associée à ce coffre de sauvegarde. Type : Chaîne ** [MpaSessionArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN de la session MPA associée à ce coffre de sauvegarde. Type : Chaîne ** [NumberOfRecoveryPoints](#API_DescribeBackupVault_ResponseSyntax) ** Nombre de points de récupération stockés dans un coffre-fort de sauvegarde. La valeur du nombre de points de récupération affichée dans la console peut être approximative. Utilisez l’API [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListRecoveryPointsByBackupVault.html) pour obtenir le nombre exact. Type : Long ** [SourceBackupVaultArn](#API_DescribeBackupVault_ResponseSyntax) ** L'ARN du coffre de sauvegarde source à partir duquel ce coffre de sauvegarde d'accès à la restauration a été créé. Type : Chaîne ** [VaultState](#API_DescribeBackupVault_ResponseSyntax) ** État actuel du coffre. -> Type : Chaîne Valeurs valides : `CREATING | AVAILABLE | FAILED` ** [VaultType](#API_DescribeBackupVault_ResponseSyntax) ** Type de coffre décrit. Type : Chaîne Valeurs valides : `BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT | RESTORE_ACCESS_BACKUP_VAULT` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md). ** InvalidParameterValueException ** Indique une erreur avec la valeur d'un paramètre. Par exemple, la valeur est hors de portée. ** Context ** ** Type ** Code d’état HTTP : 400 ** MissingParameterValueException ** Indique qu'un paramètre obligatoire est manquant. ** Context ** ** Type ** Code d’état HTTP : 400 ** ResourceNotFoundException ** Aucune ressource requise pour l'action n'existe. ** Context ** ** Type ** Code d’état HTTP : 400 ** ServiceUnavailableException ** La demande a échoué en raison d'une défaillance temporaire du serveur. ** Context ** ** Type ** Code d’état HTTP : 500 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/DescribeBackupVault) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/DescribeBackupVault)