arc-region-switch

Answers questions about ARC Region switch architecture, plans, execution blocks, and cross-Region failover orchestration.

2.5k|282|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/aws/agent-toolkit-for-aws --skill arc-region-switch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arc-region-switch
Source: https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/resilience-skills/arc-region-switch
Command: npx skills add https://github.com/aws/agent-toolkit-for-aws --skill arc-region-switch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams adopting Amazon Application Recovery Controller (ARC) Region switch often struggle to understand its plan-based orchestration model, choose between active/active and active/passive designs, and position it correctly against legacy routing controls. This Skill turns the agent into a subject-matter expert that answers architecture, positioning, and troubleshooting questions accurately.

Core Features & Use Cases

  • Architecture Guidance: Explains plans, workflows, steps, execution blocks, triggers, execution modes, and recovery time tracking for cross-Region failover orchestration.
  • Customer Positioning: Provides curated framing, Region switch vs Routing Controls comparisons, and analyst talking points via the references/positioning.md file.
  • Documentation Routing: Maps question types to the correct official AWS documentation links via references/doc-links.md.
  • Use Case: A solutions architect preparing for a customer meeting asks how Region switch handles cross-account database failover; the agent answers with correct terminology, security guidance, and links to the relevant AWS docs.

Quick Start

Ask the agent to explain how ARC Region switch orchestrates a cross-Region failover for an active/passive application and which execution blocks to use.

Frequently Asked Questions about arc-region-switch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does ARC Region switch orchestrate cross-Region failover?

ARC Region switch uses plans containing workflows of execution blocks that perform recovery actions such as traffic rerouting, compute scaling, and database failover. Executions can run gracefully, ungracefully, or as post-recovery workflows, triggered manually or by CloudWatch alarms.

What is the difference between Region switch and Routing Controls?

Region switch is plan-based orchestration covering the full recovery lifecycle including traffic, compute, database failover, and custom actions, with native cross-account support. Routing Controls are cluster-based and handle DNS traffic switching only, without cross-account support.

Does ARC Region switch support cross-account recovery plans?

Yes, plans can orchestrate resources across multiple AWS accounts using IAM roles with cross-account trust policies. Trust policies should include condition keys like aws:SourceArn, aws:SourceAccount, and sts:ExternalId, with permissions scoped to specific resource ARNs.

Does Region switch handle data replication between Regions?

No, Region switch orchestrates failover of existing replicas but does not set up or manage replication. Use services like Aurora Global Database, DynamoDB Global Tables, or S3 Cross-Region Replication for data synchronization.

When should I not use ARC Region switch?

Do not use it for in-Region or Availability Zone failures, where ALB and Auto Scaling mechanisms apply, or for designing data replication. It is intended only for orchestrating cross-Region recovery of applications already deployed multi-Region.

Why does a cross-account Region switch execution fail?

Failures usually stem from missing IAM permissions. Verify the cross-account trust policy includes the required condition keys, the target role ARN is correct, and permissions are scoped to the specific resources referenced in the execution blocks.