From da6e125c4b2e3d09801ef3cd543e34e2cd7b3d78 Mon Sep 17 00:00:00 2001
From: Ran <huangran@pingcap.com>
Date: Wed, 22 Apr 2020 13:18:58 +0800
Subject: [PATCH] tiflash: add explanation on how to clear replication rules in
 pd (#2355)

---
 reference/tiflash/maintain.md | 45 ++++++++++++++++++++++++++++++++---
 1 file changed, 42 insertions(+), 3 deletions(-)

diff --git a/reference/tiflash/maintain.md b/reference/tiflash/maintain.md
index 60b582e742f4a..54d721470fb04 100644
--- a/reference/tiflash/maintain.md
+++ b/reference/tiflash/maintain.md
@@ -58,9 +58,48 @@ Follow the steps below to take a TiFlash node down:
 
 > **Note:**
 >
-> If you don't cancel all tables replicated to TiFlash before all TiFlash nodes stop running, you need to manually delete the replication rule in PD. Or you cannot successfully take the TiFlash node down.
->
-> To manually delete the replication rule in PD, send the `DELETE` request `http://<pd_ip>:<pd_port>/pd/api/v1/config/rule/tiflash/<rule_id>`. `rule_id` refers to the `id` of the `rule` to be deleted.
+> If you don't cancel all tables replicated to TiFlash before all TiFlash nodes stop running, you need to manually delete the replication rules in PD. Or you cannot successfully take the TiFlash node down.
+
+To manually delete the replication rules in PD, take the following steps:
+
+1. Query all the data replication rules related to TiFlash in the current PD instance:
+
+    {{< copyable "shell-regular" >}}
+
+    ```shell
+    curl http://<pd_ip>:<pd_port>/pd/api/v1/config/rules/group/tiflash
+    ```
+
+    ```
+    [
+      {
+        "group_id": "tiflash",
+        "id": "table-45-r",
+        "override": true,
+        "start_key": "7480000000000000FF2D5F720000000000FA",
+        "end_key": "7480000000000000FF2E00000000000000F8",
+        "role": "learner",
+        "count": 1,
+        "label_constraints": [
+          {
+            "key": "engine",
+            "op": "in",
+            "values": [
+              "tiflash"
+            ]
+          }
+        ]
+      }
+    ]
+    ```
+
+2. Delete all the data replication rules related to TiFlash. The following example command deletes the rule whose `id` is `table-45-r`:
+
+    {{< copyable "shell-regular" >}}
+
+    ```shell
+    curl -v -X DELETE http://<pd_ip>:<pd_port>/pd/api/v1/config/rule/tiflash/table-45-r
+    ```
 
 ## TiFlash troubleshooting