【API网关Kong系列六】- 玩转Consumer

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