DocsAWS 101BlogServices

API Gateway v1 (REST)

API Gateway v1 (REST APIs) — resources, methods, integrations, deployments, stages, authorizers, usage plans, domain names.

REST-JSON multi-tenant 69 operations

Quick start

# Use the SDK's apigateway client for control-plane ops; invoke via
# http://localhost:4566/restapis/{apiId}/{stage}/_user_request_/{path}
import boto3
api = boto3.client("apigateway", endpoint_url="http://localhost:4566",
                   region_name="us-east-1",
                   aws_access_key_id="test", aws_secret_access_key="test")
r = api.create_rest_api(name="demo")

Supported operations

69 operations exposed by this service as of MiniStack 1.4.6. Extracted directly from the handler dispatch in the source module.

CreateApiKey CreateAuthorizer CreateDeployment CreateDocumentationPart CreateDomainName CreateModel CreateResource CreateRestApi CreateStage CreateUsagePlan CreateUsagePlanKey DeleteApiKey DeleteAuthorizer DeleteDeployment DeleteDocumentationPart DeleteDomainName DeleteGatewayResponse DeleteIntegration DeleteIntegrationResponse DeleteMethod DeleteMethodResponse DeleteModel DeleteResource DeleteRestApi DeleteStage DeleteUsagePlan DeleteUsagePlanKey GetApiKey GetApiKeys GetAuthorizer GetAuthorizers GetDeployment GetDeployments GetDocumentationPart GetDocumentationParts GetDomainName GetDomainNames GetExport GetGatewayResponse GetGatewayResponses GetIntegration GetIntegrationResponse GetMethod GetMethodResponse GetModel GetModels GetResource GetResources GetRestApi GetRestApis GetStage GetStages GetTags GetUsagePlan GetUsagePlanKeys GetUsagePlans PutGatewayResponse PutIntegration PutIntegrationResponse PutMethod PutMethodResponse TagResource UntagResource UpdateAuthorizer UpdateDeployment UpdateDocumentationPart UpdateResource UpdateRestApi UpdateStage

CloudFormation

The CloudFormation engine provisions these resource types via this service:

AWS::ApiGateway::RestApi AWS::ApiGateway::Resource AWS::ApiGateway::Method AWS::ApiGateway::Deployment AWS::ApiGateway::Stage

See CloudFormation engine for intrinsic support and lifecycle details.

Known limitations

  • AccessLogSettings are accepted but no access logs are written.
  • BadRequest validation is not comprehensive for malformed templates / mappings.

Source

  • ministack/services/apigateway_v1.py

Read the source to verify the ops list above — dispatch tables and handler functions are the ground truth.