Skip to main content
Source

pub async fn alter_resource_group( &self, name: String, tier_attributes: HashMap<String, HashMap<String, String>>, ranking: String, adjoining_resource_group: String, ) -> Result<AlterResourceGroupResponse, KineticaError>

Alter an existing resource group

Alters the properties of an existing resource group to facilitate resource management.

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

  • 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’

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

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

Source

pub async fn alter_resource_group_with_opts( &self, name: String, tier_attributes: HashMap<String, HashMap<String, String>>, ranking: String, adjoining_resource_group: String, options: AlterResourceGroupRequestOptions, ) -> Result<AlterResourceGroupResponse, KineticaError>

Alter an existing resource group

Alters the properties of an existing resource group to facilitate resource management.

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

  • 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’

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

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

  • options - The optional parameters; any left unset take the server’s defaults.

Sends a pre-built AlterResourceGroupRequest to the /alter/resourcegroup endpoint.

Sends a pre-built AlterResourceGroupRequest to a specific worker URL, bypassing HA head-node selection. Used for multi-head access.