CLI: Job Categories

Learn how to use the CLI to manage job categories.


Overview

Job categories allow you to organize jobs into logical groups, simplifying monitoring, reporting, and management. This page explains how to use the DryvIQ Command-line Interface (CLI) to create, configure, and leverage job categories for improved organization and reporting. Note that the authentication parameters are provided within the configuration file in all examples. Refer to “CLI: Authentication” for more information.

SkySync References

The CLI references SkySync. This is expected. 

 

List Job Categories

Parameter Description Required Default

serach

q

Search text Optional  
offset Search offset Optional 0
limit Search page size Optional 20

Command

skysync-cli job-categories list

Example Results

ID Name
-1 Default
1  Maintenance

Example JSON Results

[
  {
    "id": -1,
    "name": "Default"
  },
  {
    "id": 1,
    "name": "Maintenance"
  }
]

Show a Job Category

Parameter Description Required
id Job category ID Required

Command With Variables

skysync-cli job-categories show {{id}}

Command With Example Variables

skysync-cli job-categories show 1

Example Results

ID   1
Name Maintenance

Example JSON Results

[
  {
    "id": 1,
    "name": "Maintenance"
  }
]

Create a Job Category

Parameter Description Type Required
name Job category name string Required

Command With Variables

skysync-cli job-categories add {{name}}

Command With Example Variables

skysync-cli job-categories add 'HR Department'

Expected Result

ID   2
Name HR Deparment

Expected JSON Result 

[
  {
    "id": 2,
    "name": "HR Department"
  }
]

Delete a Job Category

Parameter Description Required
id Job category ID Required

Command With Variables

skysync-cli job-categories delete {{id}}

Command With Example Variables

skysync-cli job-categories delete 2

Expected Result

The job category was deleted successfully.

Expected JSON Result 

The job category could not be deleted.