Set Target Address As Unhealthy
POST {{gateway}}/upstreams/:upstreamNameOrId/targets/:targetOrID/:address/unhealthy
Set Target Address As Unhealthy konghq
Set the current health status of an individual address resolved by a target in the load balancer to “unhealthy” in the entire Kong cluster.
This endpoint can be used to manually disable an address and have it stop responding to requests. Upstreams only forward requests to healthy nodes, so this call tells Kong to start skipping this address.
This call resets the health counters of the health checkers running in all workers of the Kong node, and broadcasts a cluster-wide message so that the “unhealthy” status is propagated to the whole Kong cluster.
Active health checks continue to execute for unhealthy addresses. Note that if active health checks are enabled and the probe detects that the address is actually healthy, it will automatically re-enable it again. To permanently remove a target from the balancer, you should delete a target instead.
| Attributes | Mandatory | Type | Description |
|---|---|---|---|
| upstream name or id | required | path | The unique identifier or the name of the upstream. |
| target or id | required | path | The host/port combination element of the target to set as unhealthy, or the id of an existing target entry. |
| address | required | path | The host/port combination element of the address to set as unhealthy. |