1、前景回顾
在【API网关Kong系列三】 – 战前预热 中已经对Consumer的做了介绍,在这我们在来回顾下。
Consumer 对象表示服务的使用者或者用户。您可以依靠Kong作为主数据库存储,也可以将使用者列表与数据库映射,以保持Kong与现有的主数据存储之间的一致性。
本章我们来主要介绍Consumer的API
2、创建一个Consumer
下面我们来用cUrl方式来做一个创建Consumer的示例。
$ curl -i -X POST \
--url http://localhost:8001/consumers/ \
--data "username=Jason"
响应如下
HTTP/1.1 201 Created
Content-Type: application/json
Connection: keep-alive
{
"username": "Jason",
"created_at": 1428555626000,
"id": "bbdf1c48-19dc-4ab7-cae0-ff4f59d87dc9"
}
在这一个简单的Consumer就创建完成了,是不是很简单。接着我们来了解下Consumer的其它PAI
3、Consumer API
3.1.1添加Consumer
请求地址 | /consumers |
请求方式 | POST |
参数 | |
username(可选) | 消费者的唯一名称,和custom_id 有且最少有一个 |
custom_id(可选) | 用于存储消费之的的唯一id,对于和数据库中的用户进行映射非常有用,和username 有且最少有一个 |
tags(可选) | 与consumer关联的一组tags,用于分组和过滤 |
3.1.2查询Consermer
请求地址 | /consumers/{username or id} |
请求方式 | GET |
参数 | |
username or id | 需要检索consumer 的username or id |
3.1.3 查询和特定插件关联的Consumer
请求地址 | /plugins/{plugin id}/consumer |
请求方式 | GET |
参数 | |
plugin id | 与要检索的Consumer关联的插件的id |
3.1.4 更新Consumer
请求地址 | /consumers/{username or id} |
请求方式 | PATCH |
参数 | |
username or id | 要更新Consumer 的id 或者username |
3.1.5 删除Consumer
请求地址 | /consumers/{username or id} |
请求方式 | DELETE |
参数 | |
username or id | 要删除的Consumer的id 或者 username |
4、总结
本章主要介绍了Consumer的api、从介绍上来看Consumre的使用非常简单, 其主要适合一个插件配合使用,在以后的章节会介绍道,在这我们只是先了解下有个印象。
想了解更多关于Kong网关的请移步
>>>>> 企业级API网关Kong