man(1) page: cloudscheduler job list

NAME
cloudscheduler job list - list jobs on cloudscheduler version 2 (csv2) servers
SYNOPSIS
cloudscheduler job list [ options …]
DESCRIPTION
The cloudscheduler job list action displays jobs for the current group from csv2 servers. This action is available for all users, provided they are in the group that the jobs belong to.
OPTIONS
Optional

The following are optional parameters:

-jh option, --job-hold option
If the job is held or not. Filters the job list to only jobs with a held value that matches option. The value of option must be 1 or 0 .
-jI id, --job-id id
The id and primary key of the job. Filters the job list to only the job that matches id.
-ji image, --job-image image
The name of the image the job is using. Filters the job list to only jobs that using image
-jp priority, --job-priority priority
The priority of the job. Filters the job list to only jobs that have priority. The value of priority must be an integer.
-jR requirements, --job-requirements requirements
The jobs requirements. Filters the job list to only jobs that match requirements.
-jrc cpus, --job-request-cpus cpus
The requested number of cpus for the job. Filters the job list to only jobs that match cpus.
-jrd disk, --job-request-disk disk
The requested number of GBs of disk for the job. Filters the job list to only jobs that match disk.
-jrr ram, --job-request-ram ram
The requested number of MBs of ram for the job. Filters the job list to only jobs that match ram.
-jrs swap, --job-request-swap swap
The requested number of GBs of swap for the job. Filters the job list to only jobs that match swap.
-jS status, --job-status status
The status code of the job. Filters the job list to only jobs that match status. The value of status must be an integer between 1 and 5. 1 - ** 2 - ** 3 - ** 4 - ** 5 - the job is held..so ../man/parameters/_job_target_alias.so
-ju user, --job-user user
The user for the job. Filters the job list to only jobs that match user.
Table

These options change the format of the displayed table(s):

-CSV column1 [,column2,… columnN], --comma-separated-values col- umn1 [,column2,… columnN]

Requests that a list of comma separated values be displayed instead of tabular output. Only the specified columns will be displayed from the current view (see --view ). To display all columns from the current view, specify a null string, ie. “–comma-separated-values ‘’”.
-CSEP separator, --comma-separated-values-separator separator
Specifies the column separator character to be used by the -CSV parameter when printing the result. By default, a comma (“,”) is used.
-NV , --no-view
Ignores any defined view (see --view ) for this invocation of the command. All columns present in the list will be displayed.
-ok , --only-keys
Only displays the values of the keys in this list. No other columns are displayed.
-r , --rotate
Rotate the listed table to only have a Key and a Value column. Used to improve readability of tables with many columns.

-V column1 [,column2,… columnN], --view column1 [,column2,… columnN]

Specifies a comma-seperated list of table column names which are to be displayed. All other columns will be ignored. For a command that produces multiple result tables, the column name list for each table is separated by a slash (/ ). Using this parameter defines a “view” for this and all subsequent invocations of this command; the same column selections will be displayed until the “view” is redefined by the --view option. To remove a view, specify a null string, ie. “–with ‘’”, in which case, all defined columns will be displayed. To see which tables and columns that can be displayed, use the --view-columns option.

Default: None.

-VC , --view-columns
View all table and column names associated with this command. For each table of information returned by the command, a table number, table name, a possible “optional” designation, the “key” column (those that are displayed at the beginning of every segment) names, and all remaining column names are displayed. This information is useful when creating views (see --view ) or when selecting columns for comma separated output (see --comma-sepa- rated-values ).

-w table1 [,table2,… tableN], --with table1 [,table2,… tableN]

Specifies a comma-seperated list of names of optional tables to be displayed. Some commands provide additional information which are not displayed unless specifically requested by name. To determine the information returned by any particular command, use the --view-columns ( -VC ) option which provides a list of table numbers, tables names, and columns, high-lighting optional information. This option accepts table numbers as well as tables names and the special value of ALL which will display all optional information.

Default: None.

Global

These options are avaliable on all actions:.so ../man/parameters/_group.so

-H , --long-help
Requests the man page style help for the current command. Long help can be requested for the cloudscheduler command, a specific object, or a specific object/action.
-h , --help
Requests short help for the current command. Help can be requested for the cloudscheduler command, a specific object, or a specific object/action.
-s server, --server server
The name of the target server. There must be an entry in the cloudscheduler defaults that matches server and it must have an authentication method.
-v , --version
Requests that the versions of both the CLI client and the targeted server be printed in addition to any other command output.
-xA , --expose-API
Requests trace messages detailing the API calls and responses issued and received by the cloudscheduler command.
EXAMPLES

  1. List all jobs for the current group: $ cloudscheduler job list Server: default, Active User: example, Active Group: example, User’s Groups: [‘example’, ‘testing’]

    Jobs (1/6)

    Group Job ID Cluster ID Process ID User User Data Requirements
    example example 1 2 1 2 1 1 example@example.com example@example.com None None None None

    Jobs (2/6)

    Group Job ID Target Clouds Cloud Instance Type
    Requested

    CPUs RAM {MBs}
    example example 1 2 example example example example example example 4 4 1000 1000

    Jobs (3/6)

    Group Job ID
    Requested

    Disk {GBs} Swap (GBs)

    		 Jobs per Core Image Network
    Job

    Priority
    example example 1 2 5 5 0 0 1 1 None None None None 0 0

    Jobs (4/6)

    Group Job ID
    Job

    Status Code
    Job Status Flags

    Idle Running Completed
    example example 1 2 2 2 0 0 1 1 0 0

    Jobs (5/6)

    Group Job ID
    Job Status Flags

    Held Other

    		 Keep Alive (seconds)
    example example 1 2 0 0 0 0 0 0

    Jobs (6/6)

    Group Job ID Max Spot Price State Change Date Queued Date Held Job Reason
    example example 1 2 0 0 2018-08-23 00:00:00 2018-08-23 00:00:00 2018-08-23 00:00:00 2018-08-23 00:00:00 None None

    Rows: 2

SEE ALSO
csv2 (1) csv2_job (1) csv2_job_update (1)

cloudscheduler version 2 7 November 2018 cloudscheduler(1)

Note

The results of an SQL query will be formatted differently from the Restructured Text tables shown above.