Amazon API Gateway Concepts

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

Internal

REST and Hypermedia Concepts

Resource, Method, Request, Response

Amazon Gateway URL

The URL is determined by a protocol (HTTP(S) or WSS), a hostname, a stage name and, for REST APIs, the resource path.

Amazon Gateway API Base URL

The hostname and the stage name determine the API's base URL.

Amazon Gateway Hostname

https://{restapi-id}.execute-api.{region}.amazonaws.com

Integration

Amazon API Gateway Resources that Require Redeployment

RestApi

Resource

Method

RequestValidator

MethodResponse

Integration

IntegrationResponse

GatewayResponse

DocumentationPart

DocumentationVersion

Model

ApiKey

Authorizer

VpcLink

Amazon API Gateway Resources that Require Configuration Changes without Redeployment

Account

Deployment (API Deployment)

A Deployment resource represents a REST API deployment in Amazon API Gateway. The Deployment is like an executable of an API represented by a RestApi resource. Once an RestApi is created, it requires deployment and association with a stage to make it callable by its users. To call a deployed URL, clients submit requests against the API's URL.

Resource updates require redeploying the API, whereas configuration updates to not.

DomainName

BasePathMapping

Stage

Stage

An API stage is represented by a Stage resource and represents a snapshot of the API, including methods, integrations, models, mapping templates, etc.

Usage

UsagePlan

API Documentation

See DocumentationPart and DocumentationVersion above.