Skip to main content
URL: http://<db.host>:<db.port>/create/resourcegroup
Creates a new resource group to facilitate resource management.

​
Input Parameter Description

​
name
string
Name of the group to be created. Must contain only letters, digits, and underscores, and cannot begin with a digit. Must not match existing resource group name.
​
tier_attributes
map of string to maps of string to strings
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’}}.The default value is an empty map ( {} ).
​
ranking
string
Indicates the relative ranking among existing resource groups where this new resource group will be placed.
  • first: Make this resource group the new first one in the ordering.
  • last: Make this resource group the new last one in the ordering.
  • before: Place this resource group before the one specified by input parameter adjoining_resource_group in the ordering.
  • after: Place this resource group after the one specified by input parameter adjoining_resource_group in the ordering.
​
adjoining_resource_group
string
If input parameter ranking is before or after, this field indicates the resource group before or after which the current group will be placed; otherwise, leave blank.The default value is ”.
​
options
map of string to strings
Optional parameters.The default value is an empty map ( {} ).

​
Output Parameter Description

The Kinetica server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:
​
status
String
‘OK’ or ‘ERROR’
​
message
String
Empty if success or an error message
​
data_type
String
‘create_resource_group_response’ or ‘none’ in case of an error
​
data
String
Empty string
​
data_str
JSON or String
This embedded JSON represents the result of the /create/resourcegroup endpoint:Empty string in case of an error.