AWS::Backup::RestoreTestingSelection - Amazon CloudFormation
SyntaxPropertiesReturn values
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::Backup::RestoreTestingSelection

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