man(1) page: cloudscheduler cloud status

NAME

cloudscheduler cloud status - status of clouds and jobs on cloudscheduler version 2 (csv2) servers

SYNOPSIS

cloudscheduler cloud status [ options …]

DESCRIPTION

Lists the status of Virtual Machines (VMs) and jobs for each cloud within the current group. Any user may view the cloud status, provided they are in the group that they are viewing the cloud status for.

OPTIONS

Optional

The following are optional parameters:

-cn name, --cloud-name name

A cloud name. The value for name must be one to thirty-two characters, all lower case, numeric digits, and dashes but cannot start or end with dashes.

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. Viewing the status of cloud “example”: $ cloudscheduler cloud status -cn example Server: default, Active User: jodiew, Active Group: jodiew-clg1, User’s Groups: [‘jodiew-clg1’, ‘testing’]

   Job status:

   Group	Jobs	Idle	Running	Completed	Other
   example	0	0	0	0	0

   Rows: 1

   Cloud status: (1/4)

   Group	Cloud	Defaults Enabled Flavor Image Keep Alive				VMs Total Unregistered Running
   example	example	1	cl-update	cl-update	1	0	0	0

   Cloud status: (2/4)

   Group	Cloud	VMs Retiring Manual Error Other				Cores Total Setting Idle
   example	example	0	0	0	0	0	-1	0

   Cloud status: (3/4)

   Group	Cloud	Cores Used	RAM Total Setting Idle Used				Slots Total Used
   example	example	0	0	-1	0	0	0	0

   Cloud status: (4/4)

   Group	Cloud	Foreign VMs Cores RAM
   example	example	0	0	0

   Rows: 1

SEE ALSO

csv2 (1) csv2_cloud (1) csv2_cloud_add (1) csv2_cloud_delete (1) csv2_cloud_list (1) csv2_cloud_metadata_collation (1) csv2_cloud_meta- data_delete (1) csv2_cloud_metadata_edit (1) csv2_cloud_metadata_list (1) csv2_cloud_metadata_load (1) csv2_cloud_metadata_update (1) csv2_cloud_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.