Arpio recovers Amazon API Gateway REST APIs and HTTP APIs in a separate AWS account and region. It rebuilds stages, routes, integrations, authorizers, custom domain names, VPC links, API keys, and usage plans, and rewrites every reference to Lambda functions, IAM roles, Cognito user pools, certificates, and SQS queues so they point at their recovered counterparts.
Disaster Recovery for Amazon API Gateway
What Arpio protects in Amazon API Gateway
| Resource | What Arpio does |
|---|---|
| REST APIs (v1) and HTTP APIs (v2) | Recreates the API; translates resource policies and VPC endpoint references |
| Stages and deployments | Recreates deployed stages; points access logs at the recovery account and region |
| Routes, methods, integrations | Recreates them and points Lambda and SQS integrations at recovered functions and queues |
| Authorizers | Points Lambda authorizers at recovered functions; maps Cognito authorizers to recovered user pools and clients |
| Custom domain names and mappings | Recreates them with the recovered ACM certificates |
| VPC links | Points them at recovered subnets, security groups, and network load balancers |
| API keys, usage plans, usage plan keys | Recreates the ones attached to recovered stages |
| Models, request validators, gateway responses, documentation parts | Recreates the deployed versions |
Why API Gateway exports aren’t a disaster recovery plan
API Gateway has no built-in way to copy an API into another account or region. Each API is a web of IDs: Lambda ARNs in integration URIs, Cognito pool IDs in authorizers, certificate ARNs on custom domains, subnet IDs on VPC links. Exporting an OpenAPI file captures some of the definition but none of that wiring. Arpio rebuilds the API and rewrites every reference so it works in the recovery environment.
How API Gateway disaster recovery works with Arpio
1. Select an API, stage, or custom domain. Arpio discovers what it depends on (functions, roles, user pools, certificates, queues, VPC links) and adds them automatically.
2. Arpio records the API’s configuration in each recovery point. APIs aren’t usable while idle, so Arpio creates them only when you test or fail over.
3. At recovery, Arpio rebuilds the API and its stages, routes, and integrations, translating every ARN and ID to its recovered match.
4. Custom domains come back with recovered certificates. Update DNS to send traffic to the recovered API.
Testing and failback for Amazon API Gateway
Run a recovery test whenever you want. Arpio brings up the recovery environment in test mode while production keeps serving traffic, so you can confirm the application works without a maintenance window. When the outage is over, Arpio copies the latest data from the recovery environment back to your original infrastructure, and you can rehearse failback as often as you like.
Services recovered alongside API Gateway
AWS Lambda, Amazon Cognito, AWS Certificate Manager, AWS IAM, Amazon SQS, Amazon VPC, AWS WAF.
API Gateway requirements and limits
- WebSocket APIs aren’t supported yet.
- Client certificates aren’t supported.
- For REST API methods, only Lambda and Mock integration types are supported.
- Only changes deployed to a stage are recovered; undeployed edits to methods, authorizers, and models aren’t.
- Edge-optimized APIs are recovered as regional APIs, because CloudFront won’t let the same custom domain sit on two distributions.
API Gateway disaster recovery FAQ
Does Arpio support both REST and HTTP APIs?
Yes. WebSocket APIs aren’t supported yet.
Will my custom domain work after recovery?
Yes. Arpio recreates the domain name with recovered ACM certificates; you point DNS at the recovered API.
What happens to my Lambda authorizers?
Arpio recovers the functions and rewrites the authorizer to call the recovered version.
Why are edge-optimized APIs recovered as regional?
CloudFront doesn’t allow one custom domain on two distributions, so a regional API is the only way to keep your domain name.
Want to Learn More?
See how Arpio recovers API Gateway with the rest of your application
Request a Demo