Infrastructure Optimization service command-line client¶

watcher action list¶

usage: watcher action list [-h] [-f {csv,html,json,table,value,yaml}]
                           [-c COLUMN] [--max-width <integer>] [--noindent]
                           [--quote {all,minimal,none,nonnumeric}]
                           [--action-plan <action-plan>] [--audit <audit>]
                           [--detail] [--limit <limit>] [--sort-key <field>]
                           [--sort-dir <direction>]

List information on retrieved actions.

Optional arguments:

-h, --help

show this help message and exit

--action-plan <action-plan>

UUID of the action plan used for filtering.

--audit <audit>

UUID of the audit used for filtering.

--detail

Show detailed information about actions.

--limit <limit>

Maximum number of actions to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Action field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher action show¶

usage: watcher action show [-h] [-f {html,json,shell,table,value,yaml}]
                           [-c COLUMN] [--max-width <integer>] [--noindent]
                           [--prefix PREFIX]
                           <action>

Show detailed information about a given action.

Positional arguments:

<action>

UUID of the action

Optional arguments:

-h, --help

show this help message and exit

watcher actionplan create¶

usage: watcher actionplan create [-h] [-f {html,json,shell,table,value,yaml}]
                                 [-c COLUMN] [--max-width <integer>]
                                 [--noindent] [--prefix PREFIX] -a
                                 <audit_template> [-d <deadline>]
                                 [-t <audit_type>]

Create new audit.

Optional arguments:

-h, --help

show this help message and exit

-a <audit_template>, --audit-template <audit_template>

ActionPlan template used for this audit (name or uuid).

-d <deadline>, --deadline <deadline>

Descrition of the audit.

-t <audit_type>, --audit_type <audit_type>

ActionPlan type.

watcher actionplan delete¶

usage: watcher actionplan delete [-h] <action-plan> [<action-plan> ...]

Delete action plan command.

Positional arguments:

<action-plan>

UUID of the action plan

Optional arguments:

-h, --help

show this help message and exit

watcher actionplan list¶

usage: watcher actionplan list [-h] [-f {csv,html,json,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--audit <audit>] [--detail] [--limit <limit>]
                               [--sort-key <field>] [--sort-dir <direction>]

List information on retrieved action plans.

Optional arguments:

-h, --help

show this help message and exit

--audit <audit>

UUID of an audit used for filtering.

--detail

Show detailed information about action plans.

--limit <limit>

Maximum number of action plans to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Action Plan field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher actionplan show¶

usage: watcher actionplan show [-h] [-f {html,json,shell,table,value,yaml}]
                               [-c COLUMN] [--max-width <integer>]
                               [--noindent] [--prefix PREFIX]
                               <action-plan>

Show detailed information about a given action plan.

Positional arguments:

<action-plan>

UUID of the action plan

Optional arguments:

-h, --help

show this help message and exit

watcher actionplan start¶

usage: watcher actionplan start [-h] [-f {html,json,shell,table,value,yaml}]
                                [-c COLUMN] [--max-width <integer>]
                                [--noindent] [--prefix PREFIX]
                                <action-plan>

Start action plan command.

Positional arguments:

<action-plan>

UUID of the action_plan.

Optional arguments:

-h, --help

show this help message and exit

watcher actionplan update¶

usage: watcher actionplan update [-h] [-f {html,json,shell,table,value,yaml}]
                                 [-c COLUMN] [--max-width <integer>]
                                 [--noindent] [--prefix PREFIX]
                                 <action-plan> <op> <path=value>
                                 [<path=value> ...]

Update action plan command.

Positional arguments:

<action-plan>

UUID of the action_plan.

<op>

Operation: ‘add’), ‘replace’, or ‘remove’.

<path=value>

Attribute to add, replace, or remove. Can be specified multiple times. For ‘remove’, only <path> is necessary.

Optional arguments:

-h, --help

show this help message and exit

watcher audit create¶

usage: watcher audit create [-h] [-f {html,json,shell,table,value,yaml}]
                            [-c COLUMN] [--max-width <integer>] [--noindent]
                            [--prefix PREFIX] [-d <deadline>]
                            [-t <audit_type>] [-p <name=value>]
                            [-i <interval>] [-g <goal>] [-s <strategy>]
                            [-r <host-aggregate>] [-a <audit_template>]

Create new audit.

Optional arguments:

-h, --help

show this help message and exit

-d <deadline>, --deadline <deadline>

Descrition of the audit.

-t <audit_type>, --audit_type <audit_type>

Audit type. It must be ONESHOT or CONTINUOUS. Default is ONESHOT.

-p <name=value>, --parameter <name=value>

Record strategy parameter/value metadata. Can be specified multiple times.

-i <interval>, --interval <interval>

Audit interval.

-g <goal>, --goal <goal>

Goal UUID or name associated to this audit.

-s <strategy>, --strategy <strategy>

Strategy UUID or name associated to this audit.

-r <host-aggregate>, --host-aggregate <host-aggregate>

Name or UUID of the host aggregate targeted by this audit.

-a <audit_template>, --audit-template <audit_template>

Audit template used for this audit (name or uuid).

watcher audit delete¶

usage: watcher audit delete [-h] <audit> [<audit> ...]

Delete audit command.

Positional arguments:

<audit>

UUID of the audit

Optional arguments:

-h, --help

show this help message and exit

watcher audit list¶

usage: watcher audit list [-h] [-f {csv,html,json,table,value,yaml}]
                          [-c COLUMN] [--max-width <integer>] [--noindent]
                          [--quote {all,minimal,none,nonnumeric}] [--detail]
                          [--goal <goal>] [--strategy <strategy>]
                          [--limit <limit>] [--sort-key <field>]
                          [--sort-dir <direction>]

List information on retrieved audits.

Optional arguments:

-h, --help

show this help message and exit

--detail

Show detailed information about audits.

--goal <goal>

UUID or name of the goal used for filtering.

--strategy <strategy>

UUID or name of the strategy used for filtering.

--limit <limit>

Maximum number of audits to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Audit field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher audit show¶

usage: watcher audit show [-h] [-f {html,json,shell,table,value,yaml}]
                          [-c COLUMN] [--max-width <integer>] [--noindent]
                          [--prefix PREFIX]
                          <audit>

Show detailed information about a given audit.

Positional arguments:

<audit>

UUID of the audit

Optional arguments:

-h, --help

show this help message and exit

watcher audit update¶

usage: watcher audit update [-h] [-f {html,json,shell,table,value,yaml}]
                            [-c COLUMN] [--max-width <integer>] [--noindent]
                            [--prefix PREFIX]
                            <audit> <op> <path=value> [<path=value> ...]

Update audit command.

Positional arguments:

<audit>

UUID of the audit.

<op>

Operation: ‘add’, ‘replace’, or ‘remove’.

<path=value>

Attribute to add, replace, or remove. Can be specified multiple times. For ‘remove’, only <path> is necessary.

Optional arguments:

-h, --help

show this help message and exit

watcher audittemplate create¶

usage: watcher audittemplate create [-h]
                                    [-f {html,json,shell,table,value,yaml}]
                                    [-c COLUMN] [--max-width <integer>]
                                    [--noindent] [--prefix PREFIX]
                                    [-s <strategy>] [-d <description>]
                                    [-e <key=value>] [-a <host-aggregate>]
                                    <name> <goal>

Create new audit template.

Positional arguments:

<name>

Name for this audit template.

<goal>

Goal UUID or name associated to this audit template.

Optional arguments:

-h, --help

show this help message and exit

-s <strategy>, --strategy <strategy>

Strategy UUID or name associated to this audit template.

-d <description>, --description <description>

Descrition of the audit template.

-e <key=value>, --extra <key=value>

Record arbitrary key/value metadata. Can be specified multiple times.

-a <host-aggregate>, --host-aggregate <host-aggregate>

Name or UUID of the host aggregate targeted by this audit template.

watcher audittemplate delete¶

usage: watcher audittemplate delete [-h]
                                    <audit-template> [<audit-template> ...]

Delete audit template command.

Positional arguments:

<audit-template>

UUID or name of the audit template

Optional arguments:

-h, --help

show this help message and exit

watcher audittemplate list¶

usage: watcher audittemplate list [-h] [-f {csv,html,json,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--detail] [--goal <goal>]
                                  [--strategy <strategy>] [--limit <limit>]
                                  [--sort-key <field>]
                                  [--sort-dir <direction>]

List information on retrieved audit templates.

Optional arguments:

-h, --help

show this help message and exit

--detail

Show detailed information about audit templates.

--goal <goal>

UUID or name of the goal used for filtering.

--strategy <strategy>

UUID or name of the strategy used for filtering.

--limit <limit>

Maximum number of audit templates to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Audit template field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher audittemplate show¶

usage: watcher audittemplate show [-h] [-f {html,json,shell,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent] [--prefix PREFIX]
                                  <audit-template>

Show detailed information about a given audit template.

Positional arguments:

<audit-template>

UUID or name of the audit template

Optional arguments:

-h, --help

show this help message and exit

watcher audittemplate update¶

usage: watcher audittemplate update [-h]
                                    [-f {html,json,shell,table,value,yaml}]
                                    [-c COLUMN] [--max-width <integer>]
                                    [--noindent] [--prefix PREFIX]
                                    <audit-template> <op> <path=value>
                                    [<path=value> ...]

Update audit template command.

Positional arguments:

<audit-template>

UUID or name of the audit_template.

<op>

Operation: ‘add’), ‘replace’, or ‘remove’.

<path=value>

Attribute to add, replace, or remove. Can be specified multiple times. For ‘remove’, only <path> is necessary.

Optional arguments:

-h, --help

show this help message and exit

watcher goal list¶

usage: watcher goal list [-h] [-f {csv,html,json,table,value,yaml}]
                         [-c COLUMN] [--max-width <integer>] [--noindent]
                         [--quote {all,minimal,none,nonnumeric}] [--detail]
                         [--limit <limit>] [--sort-key <field>]
                         [--sort-dir <direction>]

List information on retrieved goals.

Optional arguments:

-h, --help

show this help message and exit

--detail

Show detailed information about metric collectors.

--limit <limit>

Maximum number of goals to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Goal field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher goal show¶

usage: watcher goal show [-h] [-f {html,json,shell,table,value,yaml}]
                         [-c COLUMN] [--max-width <integer>] [--noindent]
                         [--prefix PREFIX]
                         <goal>

Show detailed information about a given goal.

Positional arguments:

<goal>

UUID or name of the goal

Optional arguments:

-h, --help

show this help message and exit

watcher scoringengine list¶

usage: watcher scoringengine list [-h] [-f {csv,html,json,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent]
                                  [--quote {all,minimal,none,nonnumeric}]
                                  [--detail] [--limit <limit>]
                                  [--sort-key <field>]
                                  [--sort-dir <direction>]

List information on retrieved scoring engines.

Optional arguments:

-h, --help

show this help message and exit

--detail

Show detailed information about scoring engines.

--limit <limit>

Maximum number of actions to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Action field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher scoringengine show¶

usage: watcher scoringengine show [-h] [-f {html,json,shell,table,value,yaml}]
                                  [-c COLUMN] [--max-width <integer>]
                                  [--noindent] [--prefix PREFIX]
                                  <scoring_engine>

Show detailed information about a given scoring engine.

Positional arguments:

<scoring_engine>

Name of the scoring engine

Optional arguments:

-h, --help

show this help message and exit

watcher strategy list¶

usage: watcher strategy list [-h] [-f {csv,html,json,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--quote {all,minimal,none,nonnumeric}]
                             [--goal <goal>] [--detail] [--limit <limit>]
                             [--sort-key <field>] [--sort-dir <direction>]

List information on retrieved strategies.

Optional arguments:

-h, --help

show this help message and exit

--goal <goal>

UUID or name of the goal

--detail

Show detailed information about each strategy.

--limit <limit>

Maximum number of strategies to return per request, 0 for no limit. Default is the maximum number used by the Watcher API Service.

--sort-key <field>

Goal field that will be used for sorting.

--sort-dir <direction>

Sort direction: “asc” (the default) or “desc”.

watcher strategy show¶

usage: watcher strategy show [-h] [-f {html,json,shell,table,value,yaml}]
                             [-c COLUMN] [--max-width <integer>] [--noindent]
                             [--prefix PREFIX]
                             <strategy>

Show detailed information about a given strategy.

Positional arguments:

<strategy>

UUID or name of the strategy

Optional arguments:

-h, --help

show this help message and exit