Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

AWS::Backup::RestoreTestingSelection

Focus mode
AWS::Backup::RestoreTestingSelection - AWS CloudFormation
Filter View

This request can be sent after CreateRestoreTestingPlan request returns successfully. This is the second part of creating a resource testing plan, and it must be completed sequentially.

This consists of RestoreTestingSelectionName, ProtectedResourceType, and one of the following:

  • ProtectedResourceArns

  • ProtectedResourceConditions

Each protected resource type can have one single value.

A restore testing selection can include a wildcard value ("*") for ProtectedResourceArns along with ProtectedResourceConditions. Alternatively, you can include up to 30 specific protected resource ARNs in ProtectedResourceArns.

Cannot select by both protected resource types AND specific ARNs. Request will fail if both are included.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::Backup::RestoreTestingSelection", "Properties" : { "IamRoleArn" : String, "ProtectedResourceArns" : [ String, ... ], "ProtectedResourceConditions" : ProtectedResourceConditions, "ProtectedResourceType" : String, "RestoreMetadataOverrides" : {Key: Value, ...}, "RestoreTestingPlanName" : String, "RestoreTestingSelectionName" : String, "ValidationWindowHours" : Integer } }

Properties

IamRoleArn

The Amazon Resource Name (ARN) of the IAM role that AWS Backup uses to create the target resource; for example:arn:aws:iam::123456789012:role/S3Access.

Required: Yes

Type: String

Update requires: No interruption

ProtectedResourceArns

You can include specific ARNs, such as ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."] or you can include a wildcard: ProtectedResourceArns: ["*"], but not both.

Required: No

Type: Array of String

Update requires: No interruption

ProtectedResourceConditions

In a resource testing selection, this parameter filters by specific conditions such as StringEquals or StringNotEquals.

Required: No

Type: ProtectedResourceConditions

Update requires: No interruption

ProtectedResourceType

The type of AWS resource included in a resource testing selection; for example, an Amazon EBS volume or an Amazon RDS database.

Required: Yes

Type: String

Update requires: Replacement

RestoreMetadataOverrides

You can override certain restore metadata keys by including the parameter RestoreMetadataOverrides in the body of RestoreTestingSelection. Key values are not case sensitive.

See the complete list of restore testing inferred metadata.

Required: No

Type: Object of String

Pattern: .+

Update requires: No interruption

RestoreTestingPlanName

Unique string that is the name of the restore testing plan.

The name cannot be changed after creation. The name must consist of only alphanumeric characters and underscores. Maximum length is 50.

Required: Yes

Type: String

Update requires: Replacement

RestoreTestingSelectionName

The unique name of the restore testing selection that belongs to the related restore testing plan.

Required: Yes

Type: String

Update requires: Replacement

ValidationWindowHours

This is amount of hours (1 to 168) available to run a validation script on the data. The data will be deleted upon the completion of the validation script or the end of the specified retention period, whichever comes first.

Required: No

Type: Integer

Update requires: No interruption

Return values

Ref

On this page

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.