AWS Deep Dive

Amazon API Gateway

Continued notes about the Amazon API Gateway.

Working with REST APIs

Deploying a REST API in Amazon API Gateway (Continued)

Stage variables can be referenced directly as stageVariables.VARIABLE_NAME in request and response header parameter mappings, but must be referenced as ${stageVariables.VARIABLE_NAME} everywhere else (including mapping templates). Interestingly, stage variables cannot be used to construct ARNs referencing Lambda functions in other accounts.

API Gateway also has the concept of a “canary release”, which allows a new version of an API to be tested using only a small percentage of the API traffic. The new version can be an iteration of the existing deployment attached to a stage (in which case the API cache is shared) or a different deployment entirely (in which case the canary uses its own cache). Canary logs wind up in both the normal API Gateway CloudWatch log group and their own prefix.

Canary deployments are triggered by adding the appropriate canary settings/variables (they seem to be called different things depending on the context) to an existing stage. (Similarly, a canary deployment is disabled by simply removing these variables.) It’s implied in the instructions that canary deployments do not use the same WAF as the main API deployment.

Things that require an API to be redeployed if updated:

Things that don’t require an API redployment when updated:

And that’s about it for REST API deployments.

Setting Up Custom Domain Names for REST APIs in API Gateway

Custom domains can only be used by public APIs. Surprisingly, it seems that API Gateway’s TLS support caps out at v1.2.

TLS certificates can either be provisioned on a bring-your-own-certificate basis, or via a service called AWS Certificate Manager.

API Gateway does support wildcard domains, and provides $context.domainName and $context.domainPrefix variables to allow per-subdomain API behavior. This means that a wildcard domain like * can have a default behavior defined, but then and can both have custom behavior bypassing these defaults.

To be continued…