.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，如下所示：

first.png

third.png

再看一下未达到限制的response header和达到限制的response header：

first header.png

可以看到在未达到限制时的header会返回前面配置的Perid和剩余请求次数。

third header.png

在达到限制时的header会返回剩余多长时间（秒）重置。
再次用Postman以get的方式请求http://localhost:5000/webapib/values，不过此次要添加header：

multi requests.png

多次请求后同样可以请求到数据，并没有受到限流配置影响。

2、全局配置

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

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

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