这个插件使用指定的状态码和消息终止传入的请求。这允许(暂时)停止服务或路由(或废弃的API实体)上的通信,甚至阻塞用户。
示例用例
- 暂时禁用服务(例如正在维护中)
- 暂时禁用路由(例如,服务的其余部分已启动并正在运行,但必须禁用特定访问点)
- 暂时禁用消费者(例如,过度消费)
- 在逻辑或设置中使用多个auth插件阻止匿名访问。
启用请求终止插件
1、在服务上启用插件
$ curl -X POST http://kong:8001/services/{service}/plugins \
--data "name=request-termination" \
--data "config.status_code=403" \
--data "config.message=So long and thanks for all the fish!"
2、同理在路由,API,消费者上启动。
3、备注:
config.status_code :要发送的响应代码。
config.message :如果使用默认响应生成器,则发送的消息。
config.body : 要发送的raw响应体,跟config.message
相互排斥
config.content_type : 为config.body
配置raw响应的内容类型,默认:application/json; charset=utf-8