> ## 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_switchover

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_switchover.rs#L32-L43)
pub async fn [admin\_switchover](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-switchover.md#method.admin_switchover)( \&self, processes: [Vec](https://doc.rust-lang.org/1.98.1/alloc/vec/struct.Vec.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, destinations: [Vec](https://doc.rust-lang.org/1.98.1/alloc/vec/struct.Vec.html)\<[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)\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Manually switch over one or more processes to another hostManually switch over one or more processes to another host. Individual ranks or entire hosts may be moved to another host.

##### Arguments

<ul>
  <li>`processes` - Indicates the process identifier to switch over to another host. Options are ‘hostN’ and ‘rankN’ where ‘N’ corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., ‘host\[N].address’ or ‘rank\[N].host’. If ‘hostN’ is provided, all processes on that host will be moved to another host. Each entry in this array will be switched over to the corresponding host entry at the same index in `destinations`.</li>
  <li>`destinations` - Indicates to which host to switch over each corresponding process given in `processes`. Each index must be specified as ‘hostN’ where ‘N’ corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., ‘host\[N].address’. Each entry in this array will receive the corresponding process entry at the same index in `processes`.</li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_switchover.rs#L67-L85)
pub async fn [admin\_switchover\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-switchover.md#method.admin_switchover_with_opts)( \&self, processes: [Vec](https://doc.rust-lang.org/1.98.1/alloc/vec/struct.Vec.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, destinations: [Vec](https://doc.rust-lang.org/1.98.1/alloc/vec/struct.Vec.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>, options: [AdminSwitchoverRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Manually switch over one or more processes to another hostManually switch over one or more processes to another host. Individual ranks or entire hosts may be moved to another host.

##### Arguments

<ul>
  <li>`processes` - Indicates the process identifier to switch over to another host. Options are ‘hostN’ and ‘rankN’ where ‘N’ corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., ‘host\[N].address’ or ‘rank\[N].host’. If ‘hostN’ is provided, all processes on that host will be moved to another host. Each entry in this array will be switched over to the corresponding host entry at the same index in `destinations`.</li>
  <li>`destinations` - Indicates to which host to switch over each corresponding process given in `processes`. Each index must be specified as ‘hostN’ where ‘N’ corresponds to the number associated with a host or rank in the Network section of the gpudb.conf file; e.g., ‘host\[N].address’. Each entry in this array will receive the corresponding process entry at the same index in `processes`.</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_switchover.rs#L88-L99)
pub async fn [admin\_switchover\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-switchover.md#method.admin_switchover_raw)( \&self, request: &[AdminSwitchoverRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

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

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/admin_switchover.rs#L103-L115)
pub async fn [admin\_switchover\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/admin-switchover.md#method.admin_switchover_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[AdminSwitchoverRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AdminSwitchoverResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Sends a pre-built [`AdminSwitchoverRequest`](https://docs.kinetica.com/content/api/rust/generated/api/struct.AdminSwitchoverRequest) 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.