Skip to content

Commit 586999d

Browse files
authored
Merge pull request #3259 from emqx/improve-tag-rate-limit-desc
fix: more description for tag modifing behavior for clients
2 parents 637bb70 + a0a914a commit 586999d

File tree

2 files changed

+17
-7
lines changed

2 files changed

+17
-7
lines changed

en_US/modules/client_tag.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,11 @@ EMQX provides fine-grained rate-limiting strategies per tag, allowing you to con
6767
| Subscribe Traffic Limit (bytes/s) | Bytes/sec | Limits the message traffic a client can deliver per second. |
6868
| Maximum QoS Level | 0, 1, 2 | Limits the maximum QoS level that clients can use when publishing or subscribing to messages. |
6969

70-
::: tip
70+
::: tip Note
71+
72+
Except for the QoS level limit, if a restriction item is left empty or set to `0`, it means no restriction is applied to that item.
7173

72-
If a limit value is empty or set to `0`, that limit is **not applied**.
74+
For the **Maximum QoS Level**, setting the value to `0` does **not** mean “no restriction.” Instead, it limits the maximum QoS level for publishing and subscribing to QoS 0.
7375

7476
:::
7577

@@ -107,8 +109,12 @@ Under the **Client Tags** tab, all created tags are displayed in a list, includi
107109

108110
- **View**: See tag names and the number of currently associated clients.
109111
- **Create**: Click **Add** to add new tags and configure rate-limiting policies. For detailed configuration descriptions, see [Configurable Limits](#configurable-limits).
110-
- **Manage**: Edit rate-limiting strategies or view the client list under a tag by clicking the **View Client List** button.
111-
- **Delete**: Delete a tag that is no longer needed.
112+
- **Manage**: Edit the rate-limiting policies of an existing tag, or click **View Client List** to check all clients associated with that tag .
113+
114+
Once the rate limiting policy is modified, all clients under this tag will automatically update and apply the new configuration at the next rate limiting check.
115+
- **Delete**: Delete a tag that is no longer needed.
116+
117+
After deletion, all clients previously associated with this tag will be reassigned to the `default` tag and immediately apply the rate limiting policy of the `default` tag.
112118

113119
### Client Search
114120

zh_CN/modules/client_tag.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,11 @@ EMQX 为每个标签提供精细化的速率限制策略,您可以针对性地
6666
| 最大 QoS 等级 | `0, 1, 2` | 限制客户端发布订阅消息的最高 QoS 等级。 |
6767

6868
::: tip 提示
69-
如果某个限制项的值为空或为 0,则代表不对此项进行任何限制。
69+
70+
除 QoS 等级限制外,如果某个限制项的值为空或为 `0`,表示不对该项进行任何限制。
71+
72+
对于**最大 QoS 等级**,当其值为 `0` 时,并不代表不进行限制,而是将客户端发布和订阅消息的最高 QoS 等级限制为 0(即 QoS 0)。
73+
7074
:::
7175

7276
### 触发机制
@@ -104,8 +108,8 @@ EMQX 为每个标签提供精细化的速率限制策略,您可以针对性地
104108

105109
- **查看**:每个标签的名称、当前关联的客户端数量。
106110
- **创建**:点击**添加**按钮,可以添加新的标签并为其配置限流策略。具体的限制项配置说明,参考[可配置的限制项](#可配置的限制项)
107-
- **管理**:对已有标签进行**编辑**(修改限流策略)或通过点击标签列表中的**查看客户端列表**按钮查看其下的客户端列表。
108-
- **删除**:删除一个不需要的标签。
111+
- **管理**:对已有标签进行**编辑**(修改限流策略)或通过点击标签列表中的**查看客户端列表**按钮查看其下的客户端列表。修改后,该标签下的所有客户端将在下一次进行限流检查时立即更新其限流配置。
112+
- **删除**:删除一个不需要的标签。删除某个标签后,该标签下原有的所有客户端将更新自身标签为 `default`,并立即应用 `default` 标签的限流配置。
109113

110114
### 客户端搜索
111115

0 commit comments

Comments
 (0)