View a markdown version of this page

还原测试推断出的元数据 - AWS Backup
列表类型覆盖值的格式

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

还原测试推断出的元数据

还原恢复点需要还原元数据。为了执行还原测试， AWS Backup 会自动推断可能有助于实现成功还原的元数据。该命令get-restore-testing-inferred-metadata可用于预览 AWS Backup 将推断的内容。该命令get-restore-job-metadata返回推断出的 AWS Backup元数据集。请注意，对于某些资源类型 (Amazon FSx) AWS Backup ，无法推断出一组完整的元数据。

推断出的还原元数据是在还原测试过程中确定的。您可以通过在 RestoreTestingSelection 的正文中添加参数 RestoreMetadataOverrides 来覆盖某些还原元数据键。某些元数据覆盖在 AWS Backup 控制台中不可用。

每个支持的资源都具有推断出的还原元数据键和值，以及可覆盖的还原元数据键。只有标required for successful restore有RestoreMetadataOverrides键值对或嵌套键值对才需要包含；其他是可选的。请注意，键值不区分大小写。

重要

AWS Backup 可以推断资源应恢复为默认设置，例如将亚马逊 EC2 实例或 Amazon RDS 集群恢复到默认 VPC。但是，如果不存在默认值，例如默认 VPC 或子网已被删除且未输入任何元数据覆盖，则还原将不会成功。

资源类型 推断出的还原元数据键和值 可覆盖的元数据

DynamoDB

deletionProtection，其中值设置为 false

encryptionType 设置为 Default

targetTableName，其中值设置为随机值（从 awsbackup-restore-test- 开始）

encryptionType

kmsMasterKeyArn

Amazon EBS

availabilityZone，其值设置为随机可用区

encrypted，其值设置为 true

availabilityZone

iops

kmsKeyId

throughput

volumesize

volumetype

Amazon EC2

disableApiTermination 值设置为 false

instanceType 值设置为正在还原的恢复点的实例类型

requiredImdsV2 值设置为 true

iamInstanceProfileName（空值或 UseBackedUpValue）

instanceType

requireImdsV2

securityGroupIds

subnetId

Amazon EFS

encrypted 值设置为 true

file-system-id 值设置为正在还原的恢复点的文件系统 ID

kmsKeyId value 设置为 alias/aws/elasticfilesystem

newFileSystem 值设置为 true

performanceMode 值设置为 generalPurpose

kmsKeyId

performanceMode

适用于 Lustre 的 Amazon FSx

lustreConfiguration 具有嵌套键。一个嵌套键是 automaticBackupRetentionDays，其值设置为 0

kmsKeyId

lustreConfiguration 具有嵌套键 logConfiguration

securityGroupIds

subnetIds, required for successful restore

适用于 ONTAP 的亚马逊 FS NetApp x

name 设置为随机值（从 awsbackup_restore_test_ 开始）

ontapConfiguration 具有嵌套键，其中包括：

  • junctionPath，其中 /name 是正在还原的卷的名称

  • sizeInMegabytes，其值设置为正在还原的恢复点的大小（以兆字节为单位）

  • snapshotPolicy，其值设置为 none

注意

对于 FSx for ONTAP 资源，您在中指定的存储虚拟机（SVM）storageVirtualMachineId决定还原卷的子网和可用区。如果您在控制台中指定SubnetIds参数，则在还原操作期间 AWS Backup 接受但忽略该参数。

要恢复到其他文件系统或可用区，请在中指定属于目标文件系统的 SVM。RestoreMetadataOverrides如果您在同一个文件系统中指定 SVM，则无论您在控制台中指定了任何子网配置，该卷都将恢复到该文件系统。

ontapConfiguration 具有特定的可覆盖嵌套键，其中包括：

  • junctionPath

  • ontapVolumeType

  • securityStyle

  • sizeInMegabytes

  • storageEfficiencyEnabled

  • storageVirtualMachineId, required for successful restore

  • tieringPolicy

Amazon FSx for OpenZFS

openZfzConfiguration，具有嵌套键，其中包括：

  • automaticBackupRetentionDays，其值设置为 0

  • deploymentType，其值设置为正在还原的恢复点的部署类型

  • throughputCapacity，其值基于 deploymentType。如果 deploymentType 为 SINGLE_AZ_1，则该值设置为 64；如果 deploymentType 为 SINGLE_AZ_2 or MULTI_AZ_1，则该值设置为 160

kmsKeyId

openZfsConfiguration 具有特定的可覆盖嵌套键，其中包括：

  • deploymentType

  • throughputCapacity

  • diskiopsConfiguration

securityGroupIds

subnetIds

Amazon FSx for Windows File Server

windowsConfiguration，具有嵌套键，其中包括：

  • automaticBackupRetentionDays，其值设置为 0

  • deploymentType，其值设置为正在还原的恢复点的部署类型

  • throughputCapacity，其值设置为 8

kmsKeyId

securityGroupIds

subnetIds required for successful restore

windowsConfiguration，带有特定的可覆盖嵌套键

  • throughputCapacity

  • activeDirectoryId required for successful restore

  • preferredSubnetId

Amazon RDS、Aurora、Amazon DocumentDB、Amazon Neptune 集群

availabilityZones，其值设置为列有多达三个随机可用区的列表

dbClusterIdentifier，从 awsbackup-restore-test 开始的随机值

engine，其值设置为正在还原的恢复点的引擎

availabilityZones

databaseName

dbClusterParameterGroupName

dbSubnetGroupName

enableCloudwatchLogsExports

enableIamDatabaseAuthentication

engine

engineMode

engineVersion

kmskeyId

port

optionGroupName

scalingConfiguration

vpcSecurityGroupIds

Amazon RDS 实例

dbInstanceIdentifier，从 awsbackup-restore-test- 开始的随机值

deletionProtection，其值设置为 false

multiAz，其值设置为 false

publiclyAccessible，其值设置为 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，从 awsbackup-restore-test- 开始的随机值

encrypted ，其值设置为 true

encryptionType，其值设置为 SSE-S3

newBucket，其值设置为 true

restoreACLs指定是否恢复 ACL。该值是您在BackupACLs禁用false时创建备份时的值。否则，该值为 true。

encryptionType

kmsKey

restoreACLs

列表类型覆盖值的格式

因为RestoreMetadataOverrides是字符串键值对的映射，所以必须将代表列表的覆盖值（例如vpcSecurityGroupIds、availabilityZones、enableCloudwatchLogsExportssecurityGroupIds、和subnetIds）指定为 JSON-array-encoded 字符串。

例如，要指定单个安全组，请执行以下操作：

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

要指定多个安全组，请执行以下操作：

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

在 AWS CloudFormation 模板中，你可以使用!Sub内部函数来引用字符串中的 JSON-array 资源属性：

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

对于中的多个值 CloudFormation：

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

此 JSON-array-string 格式适用于上表中所有列表类型的替代。有关此格式的更多示例，请参阅还原 RDS 数据库。