AWS::ARCRegionSwitch::Plan - Amazon CloudFormation
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).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::ARCRegionSwitch::Plan

Represents a Region switch plan. A plan defines the steps required to shift traffic from one Amazon Web Services Region to another.

Syntax

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

JSON

{ "Type" : "AWS::ARCRegionSwitch::Plan", "Properties" : { "AssociatedAlarms" : {Key: Value, ...}, "Description" : String, "ExecutionRole" : String, "Name" : String, "PrimaryRegion" : String, "RecoveryApproach" : String, "RecoveryTimeObjectiveMinutes" : Number, "Regions" : [ String, ... ], "Tags" : {Key: Value, ...}, "Triggers" : [ Trigger, ... ], "Workflows" : [ Workflow, ... ] } }

YAML

Type: AWS::ARCRegionSwitch::Plan Properties: AssociatedAlarms: Key: Value Description: String ExecutionRole: String Name: String PrimaryRegion: String RecoveryApproach: String RecoveryTimeObjectiveMinutes: Number Regions: - String Tags: Key: Value Triggers: - Trigger Workflows: - Workflow

Properties

AssociatedAlarms

The associated application health alarms for a plan.

Required: No

Type: Object of AssociatedAlarm

Update requires: No interruption

Description

The description for a plan.

Required: No

Type: String

Update requires: No interruption

ExecutionRole

The execution role for a plan.

Required: Yes

Type: String

Pattern: ^arn:aws[a-zA-Z0-9-]*:iam::[0-9]{12}:role/.+$

Update requires: No interruption

Name

The name for a plan.

Required: Yes

Type: String

Pattern: ^[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,30}[a-zA-Z0-9])?$

Minimum: 1

Maximum: 32

Update requires: Replacement

PrimaryRegion

The primary Region for a plan.

Required: No

Type: String

Pattern: ^[a-z]{2}-[a-z-]+-\d+$

Update requires: Replacement

RecoveryApproach

The recovery approach for a Region switch plan, which can be active/active (activeActive) or active/passive (activePassive).

Required: Yes

Type: String

Allowed values: activeActive | activePassive

Update requires: Replacement

RecoveryTimeObjectiveMinutes

The recovery time objective for a plan.

Required: No

Type: Number

Minimum: 1

Maximum: 10080

Update requires: No interruption

Regions

The Amazon Web Services Regions for a plan.

Required: Yes

Type: Array of String

Minimum: 2

Maximum: 2

Update requires: Replacement

Tags

Property description not available.

Required: No

Type: Object of String

Pattern: .+

Minimum: 0

Maximum: 256

Update requires: No interruption

Triggers

The triggers for a plan.

Required: No

Type: Array of Trigger

Update requires: No interruption

Workflows

The workflows for a plan.

Required: Yes

Type: Array of Workflow

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the Amazon Resource Name (ARN) of the plan.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Arn

The Amazon Resource Name (ARN) of the plan.

HealthChecksForPlan

Represents a Region switch plan. A plan defines the steps required to shift traffic from one Amazon Web Services Region to another.

Owner

The owner of a plan.

Version

The version for the plan.