【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

    原文作者:阅历笔记
    原文地址: https://segmentfault.com/a/1190000019923741
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞