Scroll to navigation

OPENSTACK(1) OpenStack Command Line Client OPENSTACK(1)

NAME

openstack - OpenStack Command Line Client
OpenStack Command Line

SYNOPSIS

openstack [<global-options>] <command> [<command-arguments>]
openstack help <command>
openstack --help

DESCRIPTION

openstack provides a common command-line interface to OpenStack APIs. It is generally equivalent to the CLIs provided by the OpenStack project client libraries, but with a distinct and consistent command structure.
openstack uses a similar authentication scheme as the OpenStack project CLIs, with the credential information supplied either as environment variables or as options on the command line. The primary difference is the use of 'project' in the name of the options OS_PROJECT_NAME/OS_PROJECT_ID over the old tenant-based names. 
export OS_AUTH_URL=<url-to-openstack-identity>
export OS_PROJECT_NAME=<project-name>
export OS_USERNAME=<user-name>
export OS_PASSWORD=<password>  # (optional)


OPTIONS

openstack takes global options that control overall behaviour and command-specific options that control the command operation. Most global options have a corresponding environment variable that may also be used to set the value. If both are present, the command-line option takes priority. The environment variable names are derived from the option name by dropping the leading dashes ('--'), converting each embedded dash ('-') to an underscore ('_'), and converting to upper case.
openstack recognizes the following global topions:
--os-auth-url <auth-url>
Authentication URL
--os-domain-name <auth-domain-name> | --os-domain-id <auth-domain-id>
Domain-level authorization scope (name or ID)
--os-project-name <auth-project-name> | --os-project-id <auth-project-id>
Project-level authentication scope (name or ID)
--os-project-domain-name <auth-project-domain-name> | --os-project-domain-id <auth-project-domain-id>
Domain name or id containing project
--os-username <auth-username>
Authentication username
--os-user-domain-name <auth-user-domain-name> | --os-user-domain-id <auth-user-domain-id>
Domain name or id containing user
--os-password <auth-password>
Authentication password
--os-region-name <auth-region-name>
Authentication region name
--os-default-domain <auth-domain>
Default domain ID (Default: 'default')
--os-use-keyring
Use keyring to store password (default: False)
--os-cacert <ca-bundle-file>
CA certificate bundle file
--verify | --insecure
Verify or ignore server certificate (default: verify)
--os-identity-api-version <identity-api-version>
Identity API version (Default: 2.0)
--os-XXXX-api-version <XXXX-api-version>
Additional API version options will be available depending on the installed API libraries.

COMMANDS

To get a list of the available commands: 
openstack --help


To get a description of a specific command: 
openstack help <command>


complete
Print the bash completion functions for the current command set.
help
Print help for an individual command

NOTES

The command list displayed in help output reflects the API versions selected. For example, to see Identity v3 commands OS_IDENTITY_API_VERSION must be set to 3.

EXAMPLES

Show the detailed information for server appweb01: 
openstack \
    --os-project-name ExampleCo \
    --os-username demo --os-password secrete \
    --os-auth-url http://localhost:5000:/v2.0 \
    server show appweb01


The same command if the auth environment variables ( OS_AUTH_URL, OS_PROJECT_NAME, OS_USERNAME, OS_PASSWORD) are set: 
openstack server show appweb01


Create a new image: 
openstack image create \
    --disk-format=qcow2 \
    --container-format=bare \
    --public \
    --copy-from http://somewhere.net/foo.img \
    foo


FILES

~/.openstack
Placeholder for future local state directory. This directory is intended to be shared among multiple OpenStack-related applications; contents are namespaced with an identifier for the app that owns it. Shared contents (such as ~/.openstack/cache) have no prefix and the contents must be portable.

ENVIRONMENT VARIABLES

The following environment variables can be set to alter the behaviour of openstack. Most of them have corresponding command-line options that take precedence if set.
OS_AUTH_URL
Authentication URL
OS_DOMAIN_NAME
Domain-level authorization scope (name or ID)
OS_PROJECT_NAME
Project-level authentication scope (name or ID)
OS_PROJECT_DOMAIN_NAME
Domain name or id containing project
OS_USERNAME
Authentication username
OS_USER_DOMAIN_NAME
Domain name or id containing user
OS_PASSWORD
Authentication password
OS_REGION_NAME
Authentication region name
OS_DEFAULT_DOMAIN
Default domain ID (Default: ‘default’)
OS_USE_KEYRING
Use keyring to store password (default: False)
OS_CACERT
CA certificate bundle file
OS_COMPUTE_API_VERISON
Compute API version (Default: 2)
OS_IDENTITY_API_VERISON
Identity API version (Default: 2.0)
OS_IMAGE_API_VERISON
Image API version (Default: 1)
OS_VOLUME_API_VERISON
Volume API version (Default: 1)
OS_XXXX_API_VERISON
Additional API version options will be available depending on the installed API libraries.

BUGS

Bug reports are accepted at the python-openstackclient LaunchPad project " https://bugs.launchpad.net/python-openstackclient/+bugs".

AUTHORS

Please refer to the AUTHORS file distributed with OpenStackClient.

COPYRIGHT

Copyright 2011-2014 OpenStack Foundation and the authors listed in the AUTHORS file.

LICENSE

http://www.apache.org/licenses/LICENSE-2.0

SEE ALSO

The OpenStackClient page in the OpenStack Wiki contains further documentation.
The individual OpenStack project CLIs, the OpenStack API references.

AUTHOR

OpenStack contributors

COPYRIGHT

2012-2013 OpenStack Foundation
August 15, 2014 0.4.0