Docs

Using Device Groups for Job Creation

Device groups allow you to control which set of devices a job runs on. You can direct the system to pick devices from specific groups or from the general device pool.

Who Can Create and Manage Device Groups

Device groups are managed exclusively by RobusTest administrators via the Admin Console. Only users with admin privileges can:

  • Create a device group
  • Add or remove devices from a group
  • Add or remove projects from a group
  • Delete a device group

Regular project members can use existing device groups when creating jobs but cannot create or modify them. If you need a new device group or changes to an existing one, contact your RobusTest administrator.

Prerequisites

  • At least one device group must be created by an admin.
  • Your project and the desired devices must be members of that group.

Configuring Device Groups in the Job Payload

Use the devicesGroupIDs field in the job creation API payload:

Value Behaviour
["<groupID1>", "<groupID2>"] Pick devices only from the specified group(s)
["allEligibleGroups"] Pick devices from all groups the project belongs to

Example Payload

{
  "project": "<project ID>",
  "build": {
    "aut": "<build ID>"
  },
  "runMode": "distributed",
  "devices": {
    "devicesGroupIDs": ["<groupID>"]
  }
}