create

dpsctl resource-group create Usage Guide

Create a resource group.

Usage

dpsctl resource-group create

Flags

Includes global dpsctl options.

  --external-id int               external ID (required)
  --resource-group string         resource group name (required)
  --policy-bundle string          resource group policy bundle (optional; omit to resolve and persist the current global policy bundle)
  --dpm-enable                    enable dynamic power management for the lifetime of the resource group (default: true)
  --workload-profile-ids string   workload power profile Redfish IDs (comma separated list of profile IDs) (optional)
  --prs-enabled                   enable or disable PRS dynamic power management for this resource group (default: true)
  --shared-gpu-enable             enable or disable shared-GPU behavior for this resource group (default: true)
  --priority int                  priority for power stealing/giveback ordering (0 = default and highest precedence, lower number = higher priority)
  --help, -h                      show help

Examples

Basic Usage

If you omit --policy-bundle, the server resolves the current global_policy_bundle setting when it creates the resource group and persists the resolved bundle name on that resource group. A later change to the global setting does not change the existing resource group’s selection. If the global setting is empty, the resource group has no configured bundle.

$ dpsctl resource-group create --resource-group example1 --external-id 1
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with a policy bundle

Select the required bundle when you create the resource group.

$ dpsctl resource-group create --resource-group example1 --external-id 1 --policy-bundle MaxP
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with workload profile IDs

$ dpsctl resource-group create --resource-group example1 --external-id 1 --policy-bundle MaxP --workload-profile-ids 3,4
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with prs dynamic power management disabled

By default, prs dynamic power management is enabled for resource groups. You can disable it using the --prs-enabled=false flag.

$ dpsctl resource-group create --resource-group example1 --external-id 1 --policy-bundle MaxP --prs-enabled=false
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with shared-GPU behavior enabled

Shared GPU mode defaults to on. The following command sets the flag explicitly. Refer to Shared GPU Budget for the group-wide budget and topology-constraint checks.

$ dpsctl resource-group create --resource-group example1 --external-id 1 --shared-gpu-enable
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with shared-GPU behavior disabled

Pass --shared-gpu-enable=false to keep per-node GPU caps instead of a group-wide GPU budget.

$ dpsctl resource-group create --resource-group example1 --external-id 1 --shared-gpu-enable=false
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}

Create a resource group with priority

Lower numbers are higher priority. Omitting --priority stores 0, which outranks every positive value. --priority 10 is less important than any group left at the default. This command only persists the value; redistribution runs later when giveback or stealing is triggered. Refer to Resource Group Priority.

$ dpsctl resource-group create --resource-group example1 --external-id 1 --priority 10
{
  "status": {
    "ok": true,
    "diag_msg": "Success"
  }
}