.Netcore 2.0 Ocelot Api网关教程（7）- 限流

本文介绍Ocelot中的限流，限流允许Api网关控制一段时间内特定api的总访问次数。
限流的使用非常简单，只需要添加配置即可。

1、添加限流

修改 configuration.json 配置文件，对 UpstreamPathTemplate 为 /webapib/values 的配置修改如下：

{

"UpstreamPathTemplate": "/webapib/values",
"UpstreamHttpMethod": [ "Get" ],
"RateLimitOptions": {
"ClientWhiteList": [
"myclient"
      ],
"EnableRateLimiting": true,
"Period": "1m",
"PeriodTimespan": 30,
"Limit": 2
    }
}

对 RateLimitOptions 中几个配置项做下解释：

• ClientWhiteList：一个字符串数组，在请求头中包含ClientId=xxx的请求不受限流控制，其中ClientId这个key可以修改，后边会介绍，xxx表示配置的白名单。

• EnableRateLimiting：Boolean值，是否启用限流，只有为true时，配置生效。

• Period：限流控制的时间段，可以输入 1s（1秒），1m（1分），1h（1小时），1d（1天）类似的值，以此类推。

• PeriodTimespan：超过限流限制的次数后，需要等待重置的时间（单位是秒）。

• Limit：在Period时间内最大能访问的数量。
  用一句话描述一下上边的配置：对于除了请求头中包含ClientId=myclient的请求启用限流，1分钟之内该api最多被访问2次，如果已经达到2次，从第2次请求结束起30秒后才能进行下一次访问。
  分别运行WebApiB和OcelotGetWay，使用Postman以get方式请求链接http://localhost:5000/webapib/values，如下所示：
  
  
  再看一下未达到限制的response header和达到限制的response header：
  
  可以看到在未达到限制时的header会返回前面配置的Perid和剩余请求次数。
  
  在达到限制时的header会返回剩余多长时间（秒）重置。
  再次用Postman以get的方式请求http://localhost:5000/webapib/values，不过此次要添加header：
  
  多次请求后同样可以请求到数据，并没有受到限流配置影响。

2、全局配置

同时在全局配置中可以添加一些关于限流的配置来控制是否在response header中返回限流相关的信息，以及限流的返回信息和状态码还有ClientIdHeader。
修改 GlobalConfiguration 如下：

"GlobalConfiguration": {
"ServiceDiscoveryProvider": {
"Host": "localhost",
"Port": 8500
    },
"RateLimitOptions": {
"DisableRateLimitHeaders": true,
"QuotaExceededMessage": "Stop request plz!",
"HttpStatusCode": 999,
"ClientIdHeader": "cid"
    }
}

重新运行Ocelot Api网关，请求链接如下：

Do not display rate limit headers.png

返回信息中不再包含限流相关信息。

 当达到限流时，返回的信息以及状态码也会根据配置发生变化：

细心的同学可能已经发现，在上边的两次请求中都添加了header ClientId=myclient，但是还是受到了限流控制，这是因为我们在上边的全局配置中已经将ClientId修改为cid，修改header信息重新访问，就不会再受到限流控制：

相关文章：

• .Netcore 2.0 Ocelot Api网关教程（番外篇）- Ocelot v13.x升级

• .Netcore 2.0 Ocelot Api网关教程（6）- 配置管理

• 【.NET Core项目实战-统一认证平台】第十六章 网关篇-Ocelot集成RPC服务

• ocelot 自定义认证和授权

• eShopOnContainers 知多少[9]：Ocelot gateways

• 使用Ocelot、IdentityServer4、Spring Cloud Eureka搭建微服务网关：（一）
  

原文地址：https://www.jianshu.com/p/f62ca68e26f2

.NET社区新闻，深度好文，欢迎访问公众号文章汇总 http://www.csharpkit.com