![David.T](/assets/img/avatar_default.png)
I updated, in this patchset, some examples of wacher CLI, because option format has changed (we have no more '-' character in keywords) I added a new page for the openstack client + our watcher plugin. Change-Id: Ia2ae148e4357eb64c8e3df1f3036dc992e85714c
2.4 KiB
openstack
Command-Line
Interface (CLI) with Watcher plugin
openstack
SYNOPSIS
openstack
[options] optimize
<command> [command-options]
openstack help optimize
openstack help optimize
<command>
DESCRIPTION
The openstack
command-line interface (CLI) can interact with the OpenStack infra-optim
Service (Watcher), by using our additional plugin (included into the
python-watcherclient package).
In order to use the CLI, you must provide your OpenStack username,
password, project (historically called tenant), and auth endpoint. You
can use configuration options --os-username
, --os-password
, --os-tenant-id
(or --os-tenant-name
), and --os-auth-url
, or set the
corresponding environment variables:
$ export OS_USERNAME=user
$ export OS_PASSWORD=password
$ export OS_TENANT_ID=b363706f891f48019483f8bd6503c54b # or OS_TENANT_NAME
$ export OS_TENANT_NAME=project # or OS_TENANT_ID
$ export OS_AUTH_URL=http://auth.example.com:5000/v2.0
The command-line tool will attempt to reauthenticate using the
provided credentials for every request. You can override this behavior
by manually supplying an auth token using --watcher-url
and --os-auth-token
, or by setting the corresponding
environment variables:
export WATCHER_URL=http://watcher.example.org:9322/
export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155
Since Keystone can return multiple regions in the Service Catalog,
you can specify the one you want with --os-region-name
or set the following environment
variable. (It defaults to the first in the list returned.) :
$ export OS_REGION_NAME=region
OPTIONS
To get a list of available (sub)commands and options, run:
$ openstack help optimize
To get usage and options of a command, run:
$ openstack help optimize <command>
EXAMPLES
Get information about the audit-create command:
$ openstack help optimize audit create
Get a list of available goal:
$ openstack optimize goal list
Get a list of audits:
$ openstack optimize audit list