A Serverless plugin to set API Gateway endpoint configuration for your Serverless services.
AWS recently announced regional API endpoints for API Gateway. However, this configuration is not yet supported in CloudFormation. This plugin lets you programmatically set your endpoints with a single command
- Install the plugin in your Serverless service:
$ npm install --save-dev serverless-endpoint-configuration
- Add configuration to your
plugins: - serverless-endpoint-configuration custom: endpoint: type: 'REGIONAL' updateOnDeploy: true # Default is true
sls deployto deploy your application with your configured endpoint!
By default, it will update the endpoint configuration after a deploy. If you prefer more granular control, you can set
updateOnDeploy: false in your
custom: endpoint: type: 'REGIONAL' updateOnDeploy: false
Then you can run
sls endpoints set to manually update your endpoint configuration.
- Updating configuration can take a few minutes. If you try to change back and forth too quickly, it will throw an error.
- I'd like to add a
getcommand to check current config, but the
getRestApimethod from the SDK is not returning endpointConfiguration as noted in the docs.
- This plugin will probably become irrelevant when AWS adds endpoint configuration support to CloudFormation. Enjoy it while it lasts!