View a markdown version of this page

Métadonnées déduites de tests de la restauration - AWS Backup
Format pour les valeurs de remplacement de type liste

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.

Métadonnées déduites de tests de la restauration

La restauration d’un point de récupération nécessite de restaurer les métadonnées. Pour effectuer des tests de la restauration, AWS Backup déduit automatiquement les métadonnées susceptibles d’aboutir à une restauration réussie. La commande get-restore-testing-inferred-metadata peut être utilisée pour prévisualiser ce qui AWS Backup sera déduit. La commande get-restore-job-metadata renvoie l'ensemble de métadonnées déduit par AWS Backup. Notez que pour certains types de ressources (Amazon FSx), AWS Backup il n'est pas possible de déduire un ensemble complet de métadonnées.

Les métadonnées de restauration déduites sont déterminées au cours du processus de test de la restauration. Vous pouvez remplacer certaines clés de métadonnées de restauration en incluant le paramètre RestoreMetadataOverrides dans le corps de RestoreTestingSelection. Certains remplacements de métadonnées ne sont pas disponibles dans la AWS Backup console.

Chaque ressource prise en charge possède à la fois des clés et des valeurs de métadonnées de restauration déduites et des clés de métadonnées de restauration remplaçables. Seules les paires RestoreMetadataOverrides clé-valeur ou les paires clé-valeur imbriquées marquées d'un required for successful restore poinçon doivent être incluses ; les autres sont facultatives. Notez que les valeurs de clé ne sont pas sensibles à la casse.

Important

AWS Backup peut déduire qu'une ressource doit être restaurée à ses paramètres par défaut, comme une instance Amazon EC2 ou un cluster Amazon RDS restauré sur le VPC par défaut. Toutefois, si la valeur par défaut n'est pas présente, par exemple si le VPC ou le sous-réseau par défaut a été supprimé et qu'aucune modification des métadonnées n'a été saisie, la restauration échouera.

Type de ressource Clés et valeurs de métadonnées de restauration déduites Métadonnées remplaçables

DynamoDB

deletionProtection, où la valeur est définie sur false

encryptionType a la valeur Default

targetTableName, où la valeur est définie sur une valeur aléatoire commençant par awsbackup-restore-test-

encryptionType

kmsMasterKeyArn

Amazon EBS

availabilityZone, dont la valeur est définie sur une zone de disponibilité aléatoire

encrypted, dont la valeur est définie sur true

availabilityZone

iops

kmsKeyId

throughput

volumesize

volumetype

Amazon EC2

La valeur disableApiTermination est définie sur false

La valeur instanceType est définie sur le type d’instance du point de récupération en cours de restauration

La valeur requiredImdsV2 est définie sur true

iamInstanceProfileName(nul ouUseBackedUpValue)

instanceType

requireImdsV2

securityGroupIds

subnetId

Amazon EFS

La valeur encrypted est définie sur true

La valeur file-system-id est définie sur l’ID du système de fichier du point de récupération en cours de restauration

kmsKeyId value a la valeur alias/aws/elasticfilesystem

La valeur newFileSystem est définie sur true

La valeur performanceMode est définie sur generalPurpose

kmsKeyId

performanceMode

Amazon FSx pour Lustre

lustreConfiguration possède des clés imbriquées. Une clé imbriquée est automaticBackupRetentionDays, dont la valeur est définie sur 0

kmsKeyId

lustreConfiguration possède une clé imbriquée logConfiguration

securityGroupIds

subnetIds, required for successful restore

Amazon FSx pour NetApp ONTAP

name est défini sur une valeur aléatoire commençant par awsbackup_restore_test_

ontapConfiguration possède des clés imbriquées, notamment :

  • junctionPath où /name est le nom du volume en cours de restauration

  • sizeInMegabytes, dont la valeur est définie sur la taille en mégaoctets du point de récupération en cours de restauration

  • snapshotPolicy, où la valeur est définie sur none

Note

Pour les ressources FSx for ONTAP, la machine virtuelle de stockage (SVM) que vous spécifiez storageVirtualMachineId détermine le sous-réseau et la zone de disponibilité du volume restauré. Si vous spécifiez le SubnetIds paramètre dans la console, il l' AWS Backup accepte mais l'ignore lors de l'opération de restauration.

Pour effectuer une restauration vers un autre système de fichiers ou une autre zone de disponibilité, spécifiez une SVM appartenant au système de fichiers cible de votreRestoreMetadataOverrides. Si vous spécifiez une SVM dans le même système de fichiers, le volume est restauré dans ce système de fichiers, quelle que soit la configuration de sous-réseau spécifiée dans la console.

ontapConfiguration possède des clés imbriquées spécifiques remplaçables, notamment :

  • junctionPath

  • ontapVolumeType

  • securityStyle

  • sizeInMegabytes

  • storageEfficiencyEnabled

  • storageVirtualMachineId, required for successful restore

  • tieringPolicy

Amazon FSx pour OpenZFS

openZfzConfiguration, qui possède des clés imbriquées, notamment :

  • automaticBackupRetentionDays avec une valeur définie sur 0

  • deploymentType avec une valeur définie sur le type de déploiement du point de récupération en cours de restauration

  • throughputCapacity, dont la valeur est basée sur le deploymentType. Si le deploymentType est SINGLE_AZ_1, la valeur est définie sur 64 ; si le deploymentType est SINGLE_AZ_2 or MULTI_AZ_1, la valeur est définie sur 160

kmsKeyId

openZfsConfiguration possède des clés imbriquées spécifiques remplaçables, notamment :

  • deploymentType

  • throughputCapacity

  • diskiopsConfiguration

securityGroupIds

subnetIds

Amazon FSx for Windows File Server

windowsConfiguration, qui possède des clés imbriquées, notamment :

  • automaticBackupRetentionDays avec une valeur définie sur 0

  • deploymentType avec une valeur définie sur le type de déploiement du point de récupération en cours de restauration

  • throughputCapacity avec une valeur définie sur 8

kmsKeyId

securityGroupIds

subnetIds required for successful restore

windowsConfiguration, avec des clés imbriquées spécifiques remplaçables

  • throughputCapacity

  • activeDirectoryId required for successful restore

  • preferredSubnetId

Amazon RDS, Aurora, Amazon DocumentDB, clusters Amazon Neptune

availabilityZones avec une valeur définie sur une liste de trois zones de disponibilité aléatoires au maximum

dbClusterIdentifier avec une valeur aléatoire commençant par awsbackup-restore-test

engine avec une valeur définie sur le moteur du point de récupération en cours de restauration

availabilityZones

databaseName

dbClusterParameterGroupName

dbSubnetGroupName

enableCloudwatchLogsExports

enableIamDatabaseAuthentication

engine

engineMode

engineVersion

kmskeyId

port

optionGroupName

scalingConfiguration

vpcSecurityGroupIds

Instances Amazon RDS

dbInstanceIdentifier avec une valeur aléatoire commençant par awsbackup-restore-test-

deletionProtection avec une valeur définie sur false

multiAz avec une valeur définie sur false

publiclyAccessible avec une valeur définie sur false

allocatedStorage

availabilityZones

dbInstanceClass

dbName

dbParameterGroupName

dbSubnetGroupName

domain

domainIamRoleName

enableCloudwatchLogsExports

enableIamDatabaseAuthentication

iops

licensemodel

multiAz

optionGroupName

port

processorFeatures

publiclyAccessible

storageType

vpcSecurityGroupIds

Amazon Simple Storage Service (Amazon S3)

destinationBucketName avec une valeur aléatoire commençant par awsbackup-restore-test-

encrypted avec une valeur définie sur true

encryptionType avec une valeur définie sur SSE-S3

newBucket avec une valeur définie sur true

restoreACLsspécifie s'il faut restaurer les ACL. La valeur correspond au false moment où vous avez créé la sauvegarde avec BackupACLs Disabled. Sinon, la valeur est true.

encryptionType

kmsKey

restoreACLs

Format pour les valeurs de remplacement de type liste

Comme il RestoreMetadataOverrides s'agit d'une carte de paires clé-valeur de chaîne, les valeurs de remplacement qui représentent des listes (telles quevpcSecurityGroupIds, availabilityZones enableCloudwatchLogsExportssecurityGroupIds, etsubnetIds) doivent être spécifiées sous forme de chaînes. JSON-array-encoded

Par exemple, pour spécifier un seul groupe de sécurité :

"vpcSecurityGroupIds": "[\"sg-012d52c68c6e88f00\"]"

Pour spécifier plusieurs groupes de sécurité :

"vpcSecurityGroupIds": "[\"sg-012d52c68c6e88f00\",\"sg-abcdef01234567890\"]"

Dans les AWS CloudFormation modèles, vous pouvez utiliser la fonction !Sub intrinsèque pour référencer les attributs de ressource dans la JSON-array chaîne :

RestoreMetadataOverrides:
  vpcSecurityGroupIds: !Sub '["${DBSecurityGroup.GroupId}"]'

Pour plusieurs valeurs dans CloudFormation :

RestoreMetadataOverrides:
  vpcSecurityGroupIds: !Sub '["${DBSecurityGroup.GroupId}","${AnotherSecurityGroup.GroupId}"]'

Ce JSON-array-string format s'applique à tous les remplacements de type liste dans le tableau précédent. Pour plus d'exemples de ce format, consultezRestaurer une base de données RDS.