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

# alter_resource_group

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/alter_resource_group.rs#L36-L54)
pub async fn [alter\_resource\_group](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/alter-resource-group.md#method.alter_resource_group)( \&self, name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), tier\_attributes: [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>>, ranking: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), adjoining\_resource\_group: [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)\<[AlterResourceGroupResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Alter an existing resource groupAlters the properties of an existing resource group to facilitate resource management.

##### Arguments

<ul>
  <li>
    `name` - Name of the group to be altered. Must be an existing resource group name or an empty string when used in conjunction with is\_default\_group.
  </li>

  <li>
    `tier_attributes` - Optional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max\_memory (in bytes) for the VRAM and RAM tiers.For instance, to set max VRAM capacity to 1GB per rank per GPU and max RAM capacity to 10GB per rank, use: \{‘VRAM’:\{‘max\_memory’:‘1000000000’}, ‘RAM’:\{‘max\_memory’:‘10000000000’}}
  </li>

  <li>
    `ranking` - If the resource group ranking is to be updated, this indicates the relative ranking among existing resource groups where this resource group will be placed.
  </li>

  <li>
    `adjoining_resource_group` - If `ranking` is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank.
  </li>
</ul>

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/alter_resource_group.rs#L82-L107)
pub async fn [alter\_resource\_group\_with\_opts](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/alter-resource-group.md#method.alter_resource_group_with_opts)( \&self, name: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), tier\_attributes: [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [HashMap](https://doc.rust-lang.org/1.98.1/std/collections/hash/map/struct.HashMap.html)\<[String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html)>>, ranking: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), adjoining\_resource\_group: [String](https://doc.rust-lang.org/1.98.1/alloc/string/struct.String.html), options: [AlterResourceGroupRequestOptions](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupRequestOptions.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AlterResourceGroupResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

Alter an existing resource groupAlters the properties of an existing resource group to facilitate resource management.

##### Arguments

<ul>
  <li>
    `name` - Name of the group to be altered. Must be an existing resource group name or an empty string when used in conjunction with is\_default\_group.
  </li>

  <li>
    `tier_attributes` - Optional map containing tier names and their respective attribute group limits. The only valid attribute limit that can be set is max\_memory (in bytes) for the VRAM and RAM tiers.For instance, to set max VRAM capacity to 1GB per rank per GPU and max RAM capacity to 10GB per rank, use: \{‘VRAM’:\{‘max\_memory’:‘1000000000’}, ‘RAM’:\{‘max\_memory’:‘10000000000’}}
  </li>

  <li>
    `ranking` - If the resource group ranking is to be updated, this indicates the relative ranking among existing resource groups where this resource group will be placed.
  </li>

  <li>
    `adjoining_resource_group` - If `ranking` is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank.
  </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/alter_resource_group.rs#L110-L121)
pub async fn [alter\_resource\_group\_raw](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/alter-resource-group.md#method.alter_resource_group_raw)( \&self, request: &[AlterResourceGroupRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AlterResourceGroupResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

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

[Source](https://github.com/kineticadb/kinetica-api-rust/blob/master/crates/gpudb-api/src/generated/alter_resource_group.rs#L125-L137)
pub async fn [alter\_resource\_group\_from\_url](https://docs.kinetica.com/content/api/rust/gpudb/struct.Kinetica/alter-resource-group.md#method.alter_resource_group_from_url)( \&self, url: &[str](https://doc.rust-lang.org/1.98.1/std/primitive.str.html), request: &[AlterResourceGroupRequest](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupRequest.md), ) -> [Result](https://doc.rust-lang.org/1.98.1/core/result/enum.Result.html)\<[AlterResourceGroupResponse](https://docs.kinetica.com/content/api/rust/generated/api/struct.AlterResourceGroupResponse.md), [KineticaError](https://docs.kinetica.com/content/api/rust/errors/enum.KineticaError.md)>

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