Infrastructure Optimization service (watcher) command-line client¶

watcher action list¶

usage: watcher action list [-h] [-f {csv,html,json,table,value,yaml}]
                           [-c COLUMN] [--max-width <integer>] [--fit-width]
                           [--print-empty] [--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>] [--fit-width]
                           [--print-empty] [--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 cancel¶

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

Cancel action plan command.

Positional arguments:

<action-plan>

UUID of the action_plan.

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>]
                                 [--fit-width] [--print-empty] [--noindent]
                                 [--prefix PREFIX] -a <audit_template>
                                 [-t <audit_type>]

Create new audit.

Optional arguments:

-h, --help

show this help message and exit

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

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

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

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

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>]
                               [--fit-width] [--print-empty] [--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>]
                               [--fit-width] [--print-empty] [--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>]
                                [--fit-width] [--print-empty] [--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>]
                                 [--fit-width] [--print-empty] [--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>] [--fit-width]
                            [--print-empty] [--noindent] [--prefix PREFIX]
                            [-t <audit_type>] [-p <name=value>]
                            [-i <interval>] [-g <goal>] [-s <strategy>]
                            [-a <audit_template>] [--auto-trigger]

Create new audit.

Optional arguments:

-h, --help

show this help message and exit

-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 (in seconds or cron format). Cron inteval can be used like: “*/5 * * * *”. Only used if the audit is CONTINUOUS.

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

Goal UUID or name associated to this audit.

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

Strategy UUID or name associated to this audit.

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

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

--auto-trigger

Trigger automatically action plan once audit is succeeded.

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>] [--fit-width]
                          [--print-empty] [--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>] [--fit-width]
                          [--print-empty] [--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>] [--fit-width]
                            [--print-empty] [--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>]
                                    [--fit-width] [--print-empty] [--noindent]
                                    [--prefix PREFIX] [-s <strategy>]
                                    [-d <description>] [--scope <path>]
                                    <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>

Description of the audit template.

--scope <path>

Part of the cluster on which an audit will be done. Can be provided either in yaml or json file. YAML example: —- host_aggregates: - id: 1 - id: 2 - id: 3 - availability_zones: - name: AZ1 - name: AZ2 - exclude: - instances: - uuid: UUID1 - uuid: UUID2 - compute_nodes: - name: compute1

JSON example: [{‘host_aggregates’: [ {‘id’: 1}, {‘id’: 2}, {‘id’: 3}]}, {‘availability_zones’: [ {‘name’: ‘AZ1’}, {‘name’: ‘AZ2’}]}, {‘exclude’: [ {‘instances’: [ {‘uuid’: ‘UUID1’}, {‘uuid’: ‘UUID2’} ]}, {‘compute_nodes’: [ {‘name’: ‘compute1’} ]} ]}]

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>]
                                  [--fit-width] [--print-empty] [--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>]
                                  [--fit-width] [--print-empty] [--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>]
                                    [--fit-width] [--print-empty] [--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>] [--fit-width]
                         [--print-empty] [--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 each goal.

--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>] [--fit-width]
                         [--print-empty] [--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>]
                                  [--fit-width] [--print-empty] [--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>]
                                  [--fit-width] [--print-empty] [--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 service list¶

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

List information on retrieved services.

Optional arguments:

-h, --help

show this help message and exit

--detail

Show detailed information about each service.

--limit <limit>

Maximum number of services 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 service show¶

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

Show detailed information about a given service.

Positional arguments:

<service>

ID or name of the service

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>] [--fit-width]
                             [--print-empty] [--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>] [--fit-width]
                             [--print-empty] [--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