creating-api-gateway-stage

Creates API Gateway stages with CloudWatch logging, X-Ray tracing, throttling, and WAF integration.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill creating-api-gateway-stage-sakicodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: creating-api-gateway-stage
Source: https://github.com/sakicodes/BuildFestHackathon26/tree/main/.agents/skills/creating-api-gateway-stage
Command: npx skills add https://github.com/sakicodes/BuildFestHackathon26 --skill creating-api-gateway-stage-sakicodes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Deploying a REST API to a new environment requires manually configuring logging, tracing, throttling, security, and authorization across multiple AWS services, which is error-prone and time-consuming. ## Core Features & Use Cases - Full Stage Provisioning: Creates an API Gateway stage linked to a deployment with stage variables and X-Ray tracing enabled. - Observability Setup: Configures CloudWatch log groups, retention policies, IAM roles, access logging, and method-level execution logging. - Security Controls: Applies throttling limits, creates and associates a WAFv2 web ACL with managed rule sets, and guides authorization configuration (IAM, API keys, Lambda authorizers). - Use Case: When promoting a REST API from dev to production, run this procedure to create the prod stage with consistent logging, rate limiting, and WAF protection following AWS best practices. ## Quick Start Create a production stage for my REST API with CloudWatch logging, throttling limits, and WAF protection enabled.

Frequently Asked Questions about creating-api-gateway-stage

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

FAQPage Schema
How do I create an API Gateway stage with CloudWatch logging?

Create the stage with aws apigateway create-stage, then configure an IAM role with the AmazonAPIGatewayPushToCloudWatchLogs policy and set it as the account cloudwatchRoleArn. Finally enable access and execution logging via update-stage patch operations on the stage.

How to enable WAF on an API Gateway stage?

Create a WAFv2 web ACL with REGIONAL scope and managed rule groups like AWSManagedRulesCommonRuleSet, then associate it using aws wafv2 associate-web-acl with the stage resource ARN. The procedure also adds a rate-based rule to prevent abuse.

Why are CloudWatch logs not appearing for my API Gateway stage?

Missing logs usually mean the CloudWatch IAM role lacks permissions, the log group does not exist, or logging is not enabled at both stage and method levels. Verify the account cloudwatchRoleArn and the /*/*/logging/loglevel method setting.

What throttling limits should I set for API Gateway stages?

The procedure defaults to a rate limit of 1000 requests per second and a burst limit of 2000, applied via update-stage patch operations on /*/*/throttling paths. Adjust these values based on your account limits and expected traffic patterns.

Can I configure authorization after creating an API Gateway stage?

Yes, authorization can be configured at any time after stage creation. Options include NONE, IAM, API keys, Lambda authorizers, or custom authorizers, with IAM, API keys, or Lambda recommended for production environments.