website: mention node name for "agent/force-leave" HTTP endpoint (#4542)

* Adjust documentation for agent/force-leave endpoint

A node must be specified when calling agent/force-leave.
See:
 - https://github.com/hashicorp/consul/blob/master/agent/http_oss.go#L25
 - https://github.com/hashicorp/consul/blob/master/agent/agent_endpoint.go#L323
 - https://github.com/hashicorp/consul/blob/master/agent/agent.go#L1442

However, the documentation does not specify it.
Note that Consul returns "301 Moved Permanently v1/agent/force-leave/" when sending PUT request on "v1/agent/force-leave".

* Switch from node id to node name
pull/4728/head
Yoann Fouquet 6 years ago committed by Hans Hasselberg
parent e7629564ef
commit a7f83b62f3

@ -488,7 +488,7 @@ state allows its old entries to be removed.
| Method | Path | Produces |
| ------ | ---------------------------- | -------------------------- |
| `PUT` | `/agent/force-leave` | `application/json` |
| `PUT` | `/agent/force-leave/:node` | `application/json` |
The table below shows this endpoint's support for
[blocking queries](/api/index.html#blocking-queries),
@ -500,12 +500,16 @@ The table below shows this endpoint's support for
| ---------------- | ----------------- | ------------- | ------------- |
| `NO` | `none` | `none` | `agent:write` |
### Parameters
- `node` `(string: <required>)` - Specifies the name of the node to be forced into `left` state. This is specified as part of the URL.
### Sample Request
```text
$ curl \
--request PUT \
http://127.0.0.1:8500/v1/agent/force-leave
http://127.0.0.1:8500/v1/agent/force-leave/agent-one
```
## Update ACL Tokens

Loading…
Cancel
Save