> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# admin_remove_host

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_remove_host.rs#L26-L32)
pub async fn [admin\_remove\_host](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-remove-host.md#method.admin_remove_host)( \&self, host: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Removes a host from the cluster.Removes a host from an existing cluster. If the host to be removed has any ranks running on it, the ranks must be removed using `/admin/remove/ranks` or manually switched over to a new host using `/admin/switchover` prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using `/admin/switchover`.

##### Arguments

<ul>
  <li>`host` - Identifies the host this applies to. Can be the host address, or formatted as ‘hostN’ where N is the host number as specified in gpudb.conf.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_remove_host.rs#L50-L66)
pub async fn [admin\_remove\_host\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-remove-host.md#method.admin_remove_host_with_opts)( \&self, host: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), options: [AdminRemoveHostRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Removes a host from the cluster.Removes a host from an existing cluster. If the host to be removed has any ranks running on it, the ranks must be removed using `/admin/remove/ranks` or manually switched over to a new host using `/admin/switchover` prior to host removal. If the host to be removed has the graph server or SQL planner running on it, these must be manually switched over to a new host using `/admin/switchover`.

##### Arguments

<ul>
  <li>`host` - Identifies the host this applies to. Can be the host address, or formatted as ‘hostN’ where N is the host number as specified in gpudb.conf.</li>
  <li>`options` - The optional parameters; any left unset take the server’s defaults.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_remove_host.rs#L69-L80)
pub async fn [admin\_remove\_host\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-remove-host.md#method.admin_remove_host_raw)( \&self, request: &[AdminRemoveHostRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AdminRemoveHostRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostRequest) to the `/admin/remove/host` endpoint.

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_remove_host.rs#L84-L96)
pub async fn [admin\_remove\_host\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-remove-host.md#method.admin_remove_host_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[AdminRemoveHostRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminRemoveHostResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AdminRemoveHostRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminRemoveHostRequest) to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.