Command-line Tool Reference

In order to use the CLI, you must provide your OpenStack username, password, tenant, and auth endpoint. Use the corresponding configuration options (--os-username, --os-password, --os-tenant-id, and --os-auth-url) or set them in environment variables:

export OS_USERNAME=user
export OS_PASSWORD=pass
export OS_TENANT_ID=b363706f891f48019483f8bd6503c54b
export OS_AUTH_URL=http://auth.example.com:5000/v3/

The command line tool will attempt to reauthenticate using your provided credentials for every request. You can override this behavior by manually supplying an auth token using --os-watcher-url and --os-auth-token. You can alternatively set these environment variables:

export OS_WATCHER_URL=http://watcher.example.org:9322/
export OS_AUTH_TOKEN=3bcc3d3a03f44e3d8377f9247b0ad155

Once you’ve configured your authentication parameters, you can run watcher help to see a complete listing of available commands.

• watcher Command-Line Interface (CLI)
  • SYNOPSIS
  • DESCRIPTION
  • OPTIONS
  • EXAMPLES
• openstack Command-Line Interface (CLI) with Watcher plugin
  • SYNOPSIS
  • DESCRIPTION
  • OPTIONS
  • EXAMPLES
• Infrastructure Optimization service (watcher) command-line client
  • watcher usage
  • watcher optional arguments
    • watcher action list
    • watcher action show
    • watcher actionplan cancel
    • watcher actionplan create
    • watcher actionplan delete
    • watcher actionplan list
    • watcher actionplan show
    • watcher actionplan start
    • watcher actionplan update
    • watcher audit create
    • watcher audit delete
    • watcher audit list
    • watcher audit show
    • watcher audit update
    • watcher audittemplate create
    • watcher audittemplate delete
    • watcher audittemplate list
    • watcher audittemplate show
    • watcher audittemplate update
    • watcher goal list
    • watcher goal show
    • watcher scoringengine list
    • watcher scoringengine show
    • watcher service list
    • watcher service show
    • watcher datamodel list
    • watcher strategy list
    • watcher strategy show
    • watcher strategy state