CLI: Job Categories
L
Table of Contents
Overview
List Job Categories
Command
Example Results
Example JSON Results
Show a Job Category
Command With Variables
Command With Example Variables
Example Results
Example JSON Results
Create a Job Category
Command With Variables
Command With Example Variables
Expected Result
Expected JSON Result
Delete a Job Category
Command With Variables
Command With Example Variables
Expected Result
Expected JSON Result
The CLI references “skysync.” This is expected.
Overview
The CLI allows you to manage migration job categories. This includes retrieving a list of existing job categories, creating new categories, and deleting categories. The authentication parameters are provided within the configuration file in all examples. See CLI: Authentication for more information.
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.