hubcli role list¶
Lists all roles.
The command has the following format:
hubcli role list [flags]
where:
- flags
- One or more optional flags that provide additional control over execution of the command.
The following flags are available:
-c stringor--connection string- Specifies the name of the connection to use.
If you do not specify this option, then the default connection is used.
If there is no default connection, then you must specify a connection.
The first connection created for the Altair SLC Hub instance is set by default as the default Altair SLC Hub instance,
but a different default connection can be set using the
hubcli connection usecommand. --createdAfter time- Lists only roles created after the specified time.
--createdBefore time- Lists only roles created before the specified time.
--debug- Enables debug logging.
-hor--help- Returns help information for this command.
--includeSystem- Include system roles. By default, system roles are excluded. System roles are internal roles used by Altair SLC Hub services and are not intended for direct assignment to users.
--json- Returns the properties of the roles in JSON format.
-l intor--limit int- Lists only the number of roles specified by int. By default 100 are listed. Counting begins from the first listed role.
--modifiedAfter time- Lists only roles modified after the specified time.
--modifiedBefore time- Lists only roles modified before the specified time.
-o intor--offset int- Skips the number of roles specified by int at the beginning of the returned list.
For example, if there are 200 roles and int is set to 100, then the first 100 roles are skipped
and only the remaining roles are listed. The sort order of the list is set before the offset takes effect;
therefore the list returned is the offset of the sorted list.
The list is ordered by default by the modification time, or by the setting of the
--sortflag. -ror--relativeTimes- Displays times as relative time rather than absolute time.
--sort order- Specifies the order in which results are returned. order can be one of the following:
nameSort by name. createdSort by creation time. modifiedSort by modification time. --systemOnly- Only return system roles.
Note: ls is an alias of list.
Examples¶
Running hubcli role list returns all non-system roles:
NAME CREATED MODIFIED
Admin 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
UserManager 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
BatchJobUser 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
DataAccessConsumer 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
ExecutionProfileUser 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
Running hubcli role list -r displays the same list with relative timestamps:
NAME CREATED MODIFIED
Admin 2 hours ago 2 hours ago
UserManager 2 hours ago 2 hours ago
BatchJobUser 2 hours ago 2 hours ago
DataAccessConsumer 2 hours ago 2 hours ago
ExecutionProfileUser 2 hours ago 2 hours ago
Running hubcli role list --includeSystem adds a SYSTEM column and includes internal service roles:
NAME SYSTEM CREATED MODIFIED
Admin false 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
UserManager false 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
BatchJobUser false 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
hub_ondmdrunner true 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
hub_jobsctrl true 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
Running hubcli role list --sort name returns the list sorted alphabetically:
NAME CREATED MODIFIED
Admin 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
ArtifactAdministrator 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
BatchJobUser 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
DataAccessConsumer 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
UserManager 2026-09-09 06:16:41 UTC 2026-09-09 06:16:41 UTC
Note: ls is an alias of list.