Amazon API Gateway Supports Canary Release Deployments

Posted on: Nov 28, 2017

You can now use canary release deployments to gradually roll out new APIs in Amazon API Gateway. This helps you more safely roll out API changes and limit the blast radius of new deployments.

Using the new stage-level settings for canaries, you can set the percentage of API requests that is handled by new API deployments to a stage. You can also define new stage variables with the canary settings. When canary settings are enabled for a stage, API Gateway will generate an additional Amazon CloudWatch Logs group and CloudWatch metrics for the requests handled by the canary deployment API. You can use these metrics to measure the effectiveness of your API changes and react to them. For example, you can gradually increase the percentage of API requests that is handled by the new API deployment or rollback the changes if errors are detected.

To get started, update your API stage settings using the AWS Management Console, AWS CLI, or SDKs and APIs. Visit our documentation to learn more.

This feature is now available in US East (N. Virginia), US East (Ohio), US West (Oregon), US West (N. California), Canada (Central), South America (São Paulo), EU (Ireland), EU (Frankfurt), EU (London), Asia Pacific (Singapore), Asia Pacific (Tokyo), Asia Pacific (Sydney), Asia Pacific (Seoul), and Asia Pacific (Mumbai) AWS regions. Visit our product page for more information about Amazon API Gateway.