juzhiyuan commented on a change in pull request #4155:
URL: https://github.com/apache/apisix/pull/4155#discussion_r623925548



##########
File path: docs/zh/latest/plugins/limit-conn.md
##########
@@ -21,62 +21,62 @@ title: limit-conn
 #
 -->
 
-限制并发请求(或并发连接)插件。
+## 简介
 
-### 属性
+启用该插件后,网关将根据预设参数限制该路由并发请求数量。
 
-| 名称               | 类型    | 必选项   | 默认值 | 有效值                                 
                                                   | 描述                         
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
 |
-| ------------------ | ------- | -------- | ------ | 
-----------------------------------------------------------------------------------------
 | 
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 |
-| conn               | integer | required |        | conn > 0                  
                                                                | 允许的最大并发请求数。超过 
`conn` 的限制、但是低于 `conn` + `burst` 的请求,将被延迟处理。                                    
                                                                                
                                                                                
                                                                                
                                                                |
-| burst              | integer | required |        | burst >= 0                
                                                                | 
允许被延迟处理的并发请求数。                                                                  
                                                                                
                                                                                
                                                                                
                                                                                
                |
-| default_conn_delay | number  | required |        | default_conn_delay > 0    
                                                                | 
默认的典型连接(或请求)的处理延迟时间。                                                            
                                                                                
                                                                                
                                                                                
                                                                                
            |
-| key                | object  | required |        | ["remote_addr", 
"server_addr", "http_x_real_ip", "http_x_forwarded_for", "consumer_name"] | 
用户指定的限制并发级别的关键字,可以是客户端 IP 或服务端 IP。<br />例如,可以使用主机名(或服务器区域)作为关键字,以便限制每个主机名的并发性。 
否则,我们也可以使用客户端地址作为关键字,这样我们就可以避免单个客户端用太多的并行连接或请求淹没我们的服务。 <br />当前接受的 key 
有:"remote_addr"(客户端 IP 地址), "server_addr"(服务端 IP 地址), 请求头中的"X-Forwarded-For" 或 
"X-Real-IP", "consumer_name"(consumer 的 username)。 |
-| rejected_code      | string  | optional | 503    | [200,...,599]             
                                                                | 当请求超过 `conn` 
+ `burst` 这个阈值时,返回的 HTTP 状态码                                                    
                                                                                
                                                                                
                                                                                
                                                                                
|
+## 参数
 
-**注:key 是可以被用户自定义的,只需要修改插件的一行代码即可完成。并没有在插件中放开是处于安全的考虑。**

Review comment:
       I reconsidered this case, do we really need this tip for users? 🤔




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to