# metalcloud-cli job-group list

List job groups with optional filtering and sorting

## Synopsis

List MetalCloud job groups with optional filtering and sorting capabilities.

This command displays all job groups in the system with their current status, types,
creation timestamps, and execution progress. You can filter results by job group ID,
type, and sort the output by various fields.

Flags:
  --filter-job-group-id strings  Filter job groups by specific job group IDs. 
                                 Accepts multiple values for listing specific groups.
                                 Example: --filter-job-group-id 10,15,20

  --filter-type strings          Filter job groups by their type. Common types include:
                                 - infrastructure_deploy: Infrastructure deployment operations
                                 - infrastructure_edit: Infrastructure modification operations
                                 - server_provision: Server provisioning operations
                                 - server_decomission: Server decommissioning operations
                                 - storage_operation: Storage-related operations
                                 - network_operation: Network configuration operations
                                 Example: --filter-type infrastructure_deploy,server_provision

  --sort-by strings              Sort results by specified fields. Format: field:direction
                                 Available fields: jobGroupId, type, createdTimestamp, status
                                 Directions: ASC (ascending), DESC (descending)
                                 Example: --sort-by createdTimestamp:DESC,jobGroupId:ASC

Examples:
  ## List all job groups
  metalcloud-cli job-group list

  ## List job groups for infrastructure operations only
  metalcloud-cli job-group list --filter-type infrastructure_deploy,infrastructure_edit

  ## List specific job groups by ID
  metalcloud-cli job-group list --filter-job-group-id 10,15

  ## List job groups sorted by creation time (newest first)
  metalcloud-cli job-group list --sort-by createdTimestamp:DESC

  ## List infrastructure deployment groups, sorted by ID
  metalcloud-cli job-group list --filter-type infrastructure_deploy --sort-by jobGroupId:ASC

Permissions:
  Requires job queue read permissions to execute this command.

```
metalcloud-cli job-group list [flags]
```

### Options

```
      --filter-job-group-id strings   Filter by job group ID.
      --filter-type strings           Filter by job group type.
  -h, --help                          help for list
      --sort-by strings               Sort by fields (e.g., jobGroupId:ASC).
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli job-group](/content/configuration/cli/metalcloud-cli_job-group.md)	 - Manage MetalCloud job groups and group operations

#### Auto generated by spf13/cobra on 11-Aug-2025