Jump to: navigation, search

Difference between revisions of "UnifiedCLI/Mapping"

(Redirected page to OpenStackClient/Commands)
 
(176 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
__NOTOC__
+
#REDIRECT [[OpenStackClient/Commands]]
−
<<[[TableOfContents]]()>>
 
  
−
= OSCLI =
+
'''''Note: this page is being deprecated in favor of a new [[OpenStackClient/Commands|OpenStackClient Commands]] page with the correct name.'''''
 +
 
 +
__TOC__
 +
 
 +
= [[OpenStackClient]] Commands =
  
 
''Part of the [[UnifiedCLI]] proposal''
 
''Part of the [[UnifiedCLI]] proposal''
  
−
''[Note that the use of the word '''object''' here is its generic meaning and not the computer science meaning.  This should be changed for consisten usage and to reduce confusion.]''
+
''[Note that the use of the word '''object''' here is its generic meaning as the target of an action.]''
 +
 
 +
= Command Structure =
 +
 
 +
The OpenStackClient has a consistent and predictable format for all of its commands.
 +
 
 +
* The top level command name is <code>openstack</code>
 +
* Sub-commands take the form:
 +
<code>openstack [<global-options>] <object> <verb> [<second-object>] [<command-local-arguments>]</code>
 +
'''''Note: The command format change was committed on 13May2013.  This is the new format.'''''
 +
 
 +
 
 +
== Command Arguments ==
 +
 
 +
* All long options names shall use '-' as the interpolation character (<code>--like-this</code>)
 +
* Authentication options conform to [[/Authentication| a revised version of]] the original [[CLIAuth]]
 +
* Global arguments generally 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 can be derived from the option by dropping the leading '--', converting all embedded dashes ('-') to underscores ('_'), and converting to upper case.
 +
* Positional arguments trail command options.  
 +
* Some commands require two objects be acted upon, both objects appear in the command and if both are positional arguments they appear in the same order as in the command.  In words it can be expressed as "(given) object1 add object2 (to it)"
 +
  * <object-1> <verb> <object-2>
 +
    * group add user
 +
    * access token list  (here, 'access token' is a two-word single object)
 +
    * user list role (needs more thinking)
 +
 
 +
== Other ==
  
−
== Command Structure ==
+
* Arguments that normally require an ID in the OS-API may also use the name or other short identifier where reasonable to support
 +
* Optional machine-parsable format is available with list and show commands.  List has an option for CSV-formatted output (see --format, --quote options for a list command) while show has an option for shell-assignment formatted output (see --format option for a show command).
  
−
=== Verbs ===
+
== Verbs ==
  
−
The verbs used by the various [[OpenStack]] default clients have been mapped to the set below that attempts to define a consistent meaning to each action.  Many of them have logical opposite actions.  Those verbs with an opposite action is noted in parens if applicable.
+
The verbs used by the default [[OpenStack]] clients are defined below to provide a consistent meaning to each action.  Many of them have logical opposite actions.  Those verbs with an opposite action are noted in parens if applicable.
  
−
* <code><nowiki>add</nowiki></code> (<code><nowiki>remove</nowiki></code>) - add an object to a container which itself is usually another object; the command is built in the order of "add object1 to object2" (<object1>-<object2>), the positional arguments also appear in that order
+
* <code>authorize</code> - authorize a token (used in OAuth)
−
* <code><nowiki>attach</nowiki></code> (<code><nowiki>detach</nowiki></code>) - connect two objects (is this different from add/remove?)
+
* <code>add</code> (<code>remove</code>) - add some object to a container object; the command is built in the order of "container add object" (<container> <object>), the positional arguments appear in the same order
 +
* <code>attach</code> (<code>detach</code>) - connect two objects (is this different from add/remove? not really, use the same argument order as <code>add</code>)
 
* <code><nowiki>create</nowiki></code> (<code><nowiki>delete</nowiki></code>) - create a new occurrance of the specified object
 
* <code><nowiki>create</nowiki></code> (<code><nowiki>delete</nowiki></code>) - create a new occurrance of the specified object
 
* <code><nowiki>delete</nowiki></code> (<code><nowiki>create</nowiki></code>) - delete a specific occurrance of the specified object
 
* <code><nowiki>delete</nowiki></code> (<code><nowiki>create</nowiki></code>) - delete a specific occurrance of the specified object
Line 39: Line 68:
 
* <code><nowiki>unset</nowiki></code> (<code><nowiki>set</nowiki></code>) - remove an attribute of the object
 
* <code><nowiki>unset</nowiki></code> (<code><nowiki>set</nowiki></code>) - remove an attribute of the object
  
−
=== Global Options ===
 
  
−
These options are common to all [[OpenStack]] clients.
+
== Objects ==
  
 +
'''''Note: these need a review to sync up with the revised object names without dashes ('-') in them.'''''
  
−
<pre><nowiki>#!csv ,
+
* <code>access-token</code> - [[#Identity|Identity]] - OAuth [[#access-token|access-token]]
−
Option, Environment Variable, , OSCLI Option, Environment Variable
+
* <code>agent</code> - [[#Compute|Compute]] - [[#agent|agent]]
−
--version,, ,--version,
+
* <code>aggregate</code> - [[#Compute|Compute]] - [[#aggregate|aggregate]]
−
--help,, ,--help,
+
* <code>bash-completion</code> - [[#Compute|Compute]] - [[#bash-completion|bash-completion]]
−
--debug,, ,--debug,
+
* <code>catalog</code> - [[#Identity|Identity]] - [[#catalog|catalog]]
−
,, ,--quiet,
+
* <code>cloudpipe</code> - [[#Compute|Compute]] - [[#cloudpipe|cloudpipe]]
−
,, ,--verbose
+
* <code>console</code> - [[#Compute|Compute]] - [[#console|console]]
−
,, ,--log-file <filename>,
+
* <code>consumer</code> - [[#Identity|Identity]] - an OAuth [[#consumer|consumer]]
−
--os-auth-url <url>,OS_AUTH_URL, ,--os-auth-url,OS_AUTH_URL
+
* <code>credential</code> - [[#API_v3|Identity v3]] - [[#credential|credential]]
−
--os-tenant-name <name>,OS_TENANT_NAME, ,--os-tenant-name <name>,OS_TENANT_NAME
+
* <code>credentials</code> - [[#Compute|Compute]] - [[#credentials|credentials]]
−
--os-tenant-id <id>,OS_TENANT_ID, ,--os-tenant-id <id>,OS_TENANT_ID
+
* <code>diagnostics</code> - [[#Compute|Compute]] - [[#diagnostics|diagnostics]]
−
--os-username <name>,OS_USERNAME, ,--os-username <name>,OS_USERNAME
+
* <code>dns</code> - [[#Compute|Compute]] - [[#dns|dns]]
−
--os-password <pw>,OS_PASSWORD, ,--os-password <pw>,OS_PASSWORD
+
* <code>domain</code> - [[#API_v3|Identity v3]] - [[#domain|domain]]
−
--os-region-name <region>,OS_REGION_NAME, ,--os-region-name <region>,OS_REGION_NAME
+
* <code>ec2-credentials</code> - [[#Identity|Identity]] - [[#ec2-credentials|ec2-credentials]]
−
--os-cacert <file>,OS_CACERT, ,--os-cacert <file>,OS_CACERT
+
* <code>endpoint</code> - [[#Identity|Identity]] - [[#endpoint|endpoint]]
−
--insecure,, ,,
+
* <code>endpoints</code> - [[#Compute|Compute]] - [[#endpoints|endpoints]]
−
,, ,--os-use-keyring,
+
* <code>fixed-ip</code> - [[#Compute|Compute]] - [[#fixed-ip|fixed-ip]]
−
</nowiki></pre>
+
* <code>flavor</code> - [[#Compute|Compute]] - [[#flavor|flavor]]
 +
* <code>floating-ip</code> - [[#Compute|Compute]] - [[#floating-ip|floating-ip]]
 +
* <code>floating-ip-pool</code> - [[#Compute|Compute]] - [[#floating-ip-pool|floating-ip-pool]]
 +
* <code>group</code> - [[#API_v3|Identity v3]] - [[#group|group]]
 +
* <code>host</code> - [[#Compute|Compute]] - [[#host|host]]
 +
* <code>hypervisor</code> - [[#Compute|Compute]] - [[#hypervisor|hypervisor]]
 +
* <code>keypair</code> - [[#Compute|Compute]] - [[#keypair|keypair]]
 +
* <code>limits</code> - [[#Compute|Compute]] - [[#limits|limits]]
 +
* <code>policy</code> - [[#API_v3|Identity v3]] - [[#policy|policy]]
 +
* <code>project</code> - [[#API_v3|Identity v3]] - [[#project|project]]
 +
* <code>quota</code> - [[#Compute|Compute]] - [[#quota|quota]]
 +
* <code>quota</code> - [[#Volume|Volume]] - [[#quota|quota]]
 +
* <code>request-token</code> - [[#Identity|Identity]] - OAuth [[#request-token|request-token]]
 +
* <code>role</code> - [[#Identity|Identity]] - [[#role|role]]
 +
* <code>secgroup</code> - [[#Compute|Compute]] - [[#secgroup|secgroup]]
 +
* <code>secgroup-group-rule</code> - [[#Compute|Compute]] - [[#secgroup-group-rule|secgroup-group-rule]]
 +
* <code>secgroup-rule</code> - [[#Compute|Compute]] - [[#secgroup-rule|secgroup-rule]]
 +
* <code>server</code> - [[#Compute|Compute]] - [[#server|server]]
 +
* <code>service</code> - [[#Identity|Identity]] - [[#service|service]]
 +
* <code>snapshot</code> - [[#Volume|Volume]] - [[#snapshot|snapshot]]
 +
* <code>tenant</code> - [[#API_v2.0|Identity v2.0]] - [[#tenant|tenant]]
 +
* <code>token</code> - [[#Identity|Identity]] - [[#token|token]]
 +
* <code>user</code> - [[#Identity|Identity]] - [[#user|user]]
 +
* <code>user role</code> - [[#Identity|Identity]] - [[#user-role|user-role]]
 +
* <code>volume</code> - [[#Volume|Volume]] - [[#volume|volume]]
 +
* <code>volume-type</code> - [[#Volume|Volume]] - [[#volume-type|volume-type]]
  
  
−
== Command Mapping Summary ==
+
== Global Options ==
  
−
This is an example mapping of the existing commands from Keystone, Nova and Glance to the <code><nowiki><verb> <object></nowiki></code> form for the new cli tool.  It reduces both the number of verbs and objects by handling some of the smaller differences with command line options.
+
The common global options from the default [[OpenStack]] clients have been mapped to the set of global options below.
  
−
Further consolidation could be achieved by additional options or by introduction secondary objects to the syntax. For example, the credentials and x509-cert (and x509-root-cert) objects could be combined:
+
{| class="wikitable"
 +
|-
 +
! OSC Option !! Environment Variable !!  !! Option !! Environment Variable
 +
|-
 +
| --version ||  || || --version ||
 +
|-
 +
| --help ||  || || --help ||
 +
|-
 +
| --debug || || || --debug ||
 +
|-
 +
| --quiet ||  || ||  ||
 +
|-
 +
| --verbose ||  || ||  ||
 +
|-
 +
| --log-file <filename> ||  || ||  ||
 +
|-
 +
| --os-auth-url <url> || OS_AUTH_URL ||  || --os-auth-url <url> || OS_AUTH_URL
 +
|-
 +
| --os-tenant-name <name> || OS_TENANT_NAME ||  || --os-tenant-name <name> || OS_TENANT_NAME
 +
|-
 +
| --os-tenant-id <id> || OS_TENANT_ID ||  || --os-tenant-id <id> || OS_TENANT_ID
 +
|-
 +
| --os-username <name> || OS_USERNAME ||  || --os-username <name> || OS_USERNAME
 +
|-
 +
| --os-password <pw> || OS_PASSWORD ||  || --os-password <pw> || OS_PASSWORD
 +
|-
 +
| --os-region-name <region> || OS_REGION_NAME ||  || --os-region-name <region> || OS_REGION_NAME
 +
|-
 +
| --os-cacert <file> || OS_CACERT ||  || --os-cacert <file> || OS_CACERT
 +
|-
 +
|  ||  || || --insecure ||
 +
|-
 +
| --os-use-keyring ||  || ||  ||
 +
|}
  
  
−
<pre><nowiki>#!csv ,
+
== Common Options ==
−
,
 
−
nova x509-create-cert [<pk-file>] [<x509-cert>],os create credentials --x509 [<pk-file>] [<x509-cert>]
 
−
nova credentials,os show credentials
 
−
nova x509-get-root-cert,os show credentials --x509 --root
 
−
</nowiki></pre>
 
  
 +
A number of options will appear in many commands and should have the same form in all commands to the extent possible.
  
−
=== Glance ===
+
{| class="wikitable"
 +
|-
 +
! Option !! Description !! Usual Default
 +
|-
 +
| --description || describes an object || none
 +
|-
 +
| --enable || Used for setting the enabled state for an object || n/a
 +
|-
 +
| --disable || Used for setting the enabled state for an object || n/a
 +
|}
  
−
Coming soon.
 
  
−
=== Keystone ===
+
= Command Mapping Summary =
  
 +
This is an example mapping of the existing commands from Keystone (Identity), Nova (Compute), Glance (Image) and Cinder (Volume) to the <code><nowiki><verb> <object></nowiki></code> form for the [[OpenStackClient]] cli tool.  It reduces both the number of verbs and objects by handling some of the smaller differences with command line options.
  
−
<pre><nowiki>#!csv ,
+
Further consolidation could be achieved by additional options or by introduction secondary objects to the syntax.  For example, the credentials and x509-cert (and x509-root-cert) objects could be combined:
−
Keystone Option, Environment Variable, , OSCLI Option, Environment Variable
 
−
--os-identity-api-version <ver>,OS_IDENTITY_API_VERSION, ,--os-identity-api-version <ver>,OS_IDENTITY_API_VERSION
 
−
--os-token <token>,OS_SERVICE_TOKEN , ,--os-token <token>,OS_TOKEN
 
−
--os-endpoint <url>,OS_SERVICE_ENDPOINT, ,--os-url <url>,OS_URL
 
−
--os-cert <file>,OS_CERT, ,,
 
−
--os-key <key-file>,OS_KEY, ,,
 
−
--os-cache,OS_CACHE, ,,
 
−
--force-new-token,, ,,
 
−
--stale-duration <seconds>,, ,,
 
−
</nowiki></pre>
 
  
  
−
'''token'''
+
{| class="wikitable"
 +
|-
 +
| nova x509-create-cert [<pk-file>] [<x509-cert>] || os create credentials --x509 [<pk-file>] [<x509-cert>]
 +
|-
 +
| nova credentials || os show credentials
 +
|-
 +
| nova x509-get-root-cert || os show credentials --x509 --root
 +
|}
  
−
<pre><nowiki>#!bash
 
−
keystone token-get [--wrap <integer>]
 
  
−
os show token [--width <pki-token-display-width>]
+
== Cross API ==
−
</nowiki></pre>
 
  
 +
Object names that appear in multiple APIs, like quota, are handled by putting their command handler classes in openstackclient.common.  If the number of these becomes large they should be moved into a subdirectory.
  
−
'''catalog'''
+
==== credentials ====
  
−
<pre><nowiki>#!bash
+
''[consider rolling the ec2 creds into this too]''
−
keystone catalog [--service <service-type>]
 
  
−
os show service [--catalog <service-type>]
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os credentials create
 +
    --x509
 +
    [<private-key-file>]
 +
    [<certificate-file>]
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova x509-create-cert
 +
    [<pk-file>]
 +
    [<x509-cert>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os credentials show
 +
    [--token]
 +
    [--user]
 +
    [--x509 [--root]]
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova credentials
 +
    [--wrap <integer>]
  
 +
nova x509-get-root-cert
 +
    [<filename>]
 +
</source>
 +
|}
  
−
'''ec2-credentials'''
+
==== limits ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
keystone ec2-credentials-create [--user <user-id>]  
+
|-
−
                      [--tenant_id <tenant-id>]
+
! OSC Command !! Implemented !! !! Keystone command
−
 
+
|-
−
os create ec2-credentials --tenant_id <tenant-id> [--user <user-id>]
+
|
−
 
+
<source lang="bash">
−
## are both args really optional?
+
os limits show
−
</nowiki></pre>
+
    --absolute [--reserved] | --rate
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova absolute-limits
 +
    [--reserved]
  
 +
nova rate-limits
  
−
<pre><nowiki>#!bash
+
cinder absolute-limits
−
keystone ec2-credentials-delete [--user <user-id>]
 
−
                      --access <access-key>
 
  
−
os delete ec2-credentials <access-key>
+
cinder rate-limits
 +
</source>
 +
|}
  
−
## what changes if --user is not provided?
+
==== quota ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os quota set
 +
    # Compute settings
 +
    [--cores <num-cores>]
 +
    [--fixed-ips <num-fixed-ips>]
 +
    [--floating-ips <num-floating-ips>]
 +
    [--injected-file-size <injected-file-bytes>]
 +
    [--injected-files <num-injected-files>]
 +
    [--instances <num-instances>]
 +
    [--key-pairs <num-key-pairs>]
 +
    [--properties <num-properties>]
 +
    [--ram <ram-mb>]
  
−
<pre><nowiki>#!bash
+
    # Volume settings
−
keystone ec2-credentials-get [--user <user-id>]  
+
    [--gigabytes <new-gigabytes>]
−
                            --access <access-key>
+
    [--snapshots <new-snapshots>]
 +
    [--volumes <new-volumes>]
  
−
os show ec2-credentials <access-key>
+
    <project>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova quota-update
 +
    [--instances <instances>]
 +
    [--cores <cores>]
 +
    [--ram <ram>]
 +
    [--volumes <volumes>]
 +
    [--gigabytes <gigabytes>]
 +
    [--floating-ips <floating_ips>]
 +
    [--metadata-items <metadata_items>]
 +
    [--injected-files <injected_files>]
 +
    [--injected-file-content-bytes <injected_file_content_bytes>]
 +
    <tenant_id>
  
−
## what changes if --user is not provided?
+
cinder quota-update
−
</nowiki></pre>
+
    [--volumes <volumes>]
 +
    [--snapshots <snapshots>]
 +
    [--gigabytes <gigabytes>]
 +
    <tenant_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os quota set
 +
    --class
 +
    # Compute settings
 +
    [--cores <num-cores>]
 +
    [--fixed-ips <num-fixed-ips>]
 +
    [--floating-ips <num-floating-ips>]
 +
    [--injected-file-size <injected-file-bytes>]
 +
    [--injected-files <num-injected-files>]
 +
    [--instances <num-instances>]
 +
    [--key-pairs <num-key-pairs>]
 +
    [--properties <num-properties>]
 +
    [--ram <ram-mb>]
  
 +
    # Volume settings
 +
    [--gigabytes <new-gigabytes>]
 +
    [--snapshots <new-snapshots>]
 +
    [--volumes <new-volumes>]
  
−
<pre><nowiki>#!bash
+
    <class>
−
keystone ec2-credentials-list [--user <user-id>]
+
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova quota-class-update
 +
    [--instances <instances>]
 +
    [--cores <cores>]
 +
    [--ram <ram>]
 +
    [--volumes <volumes>]
 +
    [--gigabytes <gigabytes>]
 +
    [--floating-ips <floating_ips>]
 +
    [--metadata-items <metadata_items>]
 +
    [--injected-files <injected_files>]
 +
    [--injected-file-content-bytes <injected_file_content_bytes>]
 +
    <class>
  
−
os list ec2-credentials [--user <user-id>]
+
cinder quota-class-update
−
</nowiki></pre>
+
    [--volumes <volumes>]
 +
    [--snapshots <snapshots>]
 +
    [--gigabytes <gigabytes>]
 +
    <tenant_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os quota show
 +
    [--default]
 +
    <project>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova quota-show
 +
    [--tenant <tenant-id>]
  
 +
cinder quota-show
 +
    <tenant_id>
  
−
'''endpoint'''
+
nova quota-defaults
 +
    <tenant_id>
  
−
<pre><nowiki>#!bash
+
cinder quota-defaults
−
keystone endpoint-create [--region <endpoint-region>]
+
    <tenant_id>
−
                        [--service_id <service-id>]
+
</source>
−
                        [--publicurl <public-url>]
+
|-
−
                        [--adminurl <admin-url>]
+
|
−
                        [--internalurl <internal-url>]
+
<source lang="bash">
 +
os quota show
 +
    --class
 +
    <class>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova quota-class-show
 +
    <class>
  
−
os create endpoint
+
cinder quota-class-show
−
        [--region <endpoint-region>]
+
    <class>
−
        [--publicurl <public-url>]
+
</source>
−
        [--adminurl <admin-url>]
+
|}
−
        [--internalurl <internal-url>]
 
−
        <service>
 
−
</nowiki></pre>
 
  
 +
== Identity ==
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
keystone endpoint-delete <endpoint-id>
+
|-
 +
! OSC Option !!  Environment Variable !!  !!  Keystone Option !!  Environment Variable
 +
|-
 +
| --os-identity-api-version <ver> || OS_IDENTITY_API_VERSION ||  || --os-identity-api-version <ver> || OS_IDENTITY_API_VERSION
 +
|-
 +
| --os-token <token> || OS_TOKEN || || --os-token <token> || OS_SERVICE_TOKEN
 +
|-
 +
| --os-url <url> || OS_URL || || --os-endpoint <url> || OS_SERVICE_ENDPOINT
 +
|-
 +
|  ||  || || --os-cert <file> || OS_CERT
 +
|-
 +
|  ||  || || --os-key <key-file> || OS_KEY
 +
|-
 +
|  ||  || || --os-cache || OS_CACHE
 +
|-
 +
|  ||  || || --force-new-token ||
 +
|-
 +
|  ||  || || --stale-duration <seconds> ||
 +
|-
 +
|}
  
−
os delete endpoint <endpoint-id>
+
=== API v2.0 ===
−
</nowiki></pre>
 
  
 +
==== catalog ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
keystone endpoint-get --service <service-type>
+
|-
−
                      [--endpoint_type <endpoint-type>]
+
! OSC Command !! Implemented !! !! Keystone command
−
                      [--attr <service-attribute>]  
+
|-
−
                      [--value <value>]
+
|
 +
<source lang="bash">
 +
os catalog show
 +
    [--service <service>]
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
keystone catalog
 +
    [--service <service-type>]
 +
</source>
 +
|}
  
−
os show endpoint
+
==== ec2 credentials ====
−
        [--type <endpoint-type>]
 
−
        [--attr <endpoint-attribute>]
 
−
        [--value <endpoint-value>]
 
−
        <service>
 
  
−
os show endpoint
+
{| class="wikitable"
−
        [--all]
+
|-
−
        <service>
+
! OSC Command !! Implemented !! !! Keystone command
−
</nowiki></pre>
+
|-
 +
|
 +
<source lang="bash">
 +
os ec2 credentials create
 +
    [--project <project>]
 +
    [--user <user>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone ec2-credentials-create
 +
    [--user <user-id>]
 +
    [--tenant_id <tenant-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ec2 credentials delete
 +
    [--user <user>]
 +
    <access-key>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone ec2-credentials-delete
 +
    [--user <user-id>]
 +
    --access <access-key>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ec2 credentials list
 +
    [--user <user>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone ec2-credentials-list
 +
    [--user <user-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ec2 credentials show
 +
    [--user <user>]
 +
    <access-key>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone ec2-credentials-get
 +
    [--user <user-id>]
 +
    --access <access-key>
 +
</source>
 +
|}
  
 +
==== endpoint ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint create
 +
    --publicurl <public-url>
 +
    [--adminurl <admin-url>]
 +
    [--internalurl <internal-url>]
 +
    [--region <endpoint-region>]
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-create
 +
    [--region <endpoint-region>]
 +
    [--service_id <service-id>]
 +
    [--publicurl <public-url>]
 +
    [--adminurl <admin-url>]
 +
    [--internalurl <internal-url>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint delete
 +
    <endpoint-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-delete
 +
    <endpoint-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
keystone endpoint-list
 
keystone endpoint-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint show
 +
    [--type <endpoint-type>]
 +
    [--attr <endpoint-attribute>]
 +
    [--value <endpoint-value>]
 +
    [--all]
 +
    <service-type>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-get
 +
    --service <service-type>
 +
    [--endpoint_type <endpoint-type>]
 +
    [--attr <service-attribute>]
 +
    [--value <value>]
 +
</source>
 +
|}
  
−
os list endpoint [--long]
+
==== role ====
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''role'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone role-create --name <role-name>
 
−
 
 
−
os create role <role-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone role-delete <role-id>
 
−
 
 
−
os delete role <role>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone role-get <role-id>
 
−
 
 
−
os show role <role>
 
−
</nowiki></pre>
 
−
 
 
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os role create
 +
    <role-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone role-create --name
 +
    <role-name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role delete
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone role-delete
 +
    <role-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
keystone role-list
 
keystone role-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role show
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone role-get
 +
    <role-id>
 +
</source>
 +
|}
  
−
os list role
+
==== service ====
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''service'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone service-create --name <name>
 
−
                        --type <type>
 
−
                        [--description <service-description>]
 
−
 
 
−
os create service
 
−
        [--type <service-type>]
 
−
        [--description <service-description>]
 
−
        <service-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone service-delete <service-id>
 
−
 
 
−
os delete service <service>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone service-get <service-id>
 
−
 
 
−
os show service <service>
 
−
</nowiki></pre>
 
  
−
 
+
{| class="wikitable"
−
<pre><nowiki>#!bash
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os service create
 +
    [--type <service-type>]
 +
    [--description <service-description>]
 +
    <service-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-create
 +
    --name <name>
 +
    --type <type>
 +
    [--description <service-description>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service delete
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-delete
 +
    <service-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
keystone service-list
 
keystone service-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service show
 +
    [--catalog]
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-get
 +
    <service-id>
 +
</source>
 +
|}
  
−
os list service [--long]
+
==== tenant ====
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''tenant'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone tenant-create --name <tenant-name>
 
−
                      [--description <tenant-description>]
 
−
                      [--enabled <true|false>]
 
−
 
 
−
os create tenant
 
−
        [--description <tenant-description>]
 
−
        [--enable | --disable]
 
−
        <tenant-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone tenant-delete <tenant-id>
 
−
 
 
−
os delete tenant <tenant>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone tenant-get <tenant-id>
 
−
 
 
−
os show tenant <tenant>
 
−
</nowiki></pre>
 
−
 
 
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os tenant create
 +
    [--description <description>]
 +
    [--enable | --disable]
 +
    <tenant-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone tenant-create
 +
    --name <tenant-name>
 +
    [--description <tenant-description>]
 +
    [--enabled <true|false>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os tenant delete
 +
    <tenant>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone tenant-delete
 +
    <tenant>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os tenant list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
keystone tenant-list
 
keystone tenant-list
−
 
+
</source>
−
os list tenant [--long]
+
|-
−
</nowiki></pre>
+
|
−
 
+
<source lang="bash">
−
 
+
os tenant set
−
<pre><nowiki>#!bash
+
    [--name <new-tenant-name>]
 +
    [--description <new-tenant-description>]
 +
    [--enable | --disable]
 +
    <tenant>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
keystone tenant-update
 
keystone tenant-update
−
        [--name <tenant_name>]
+
    [--name <tenant_name>]
−
        [--description <tenant-description>]
+
    [--description <tenant-description>]
−
        [--enabled <true|false>]
+
    [--enabled <true|false>]
−
        <tenant-id>
+
    <tenant-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os tenant show
 +
    <tenant>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone tenant-get
 +
    <tenant-id>
 +
</source>
 +
|}
  
−
os set tenant
+
==== token ====
−
        [--name <new-tenant-name>]
 
−
        [--description <new-tenant-description>]
 
−
        [--enable | --disable]
 
−
        <tenant>
 
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os token show
 +
    [--width <token-display-width>]
 +
</source>
 +
|| ??
 +
|| ||
 +
<source lang="bash">
 +
keystone token-get [--wrap <integer>]
 +
</source>
 +
|}
  
−
'''user'''
+
==== user ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
keystone user-create --name <user-name>  
+
|-
−
                    [--tenant_id <tenant-id>]
+
! OSC Command !! Implemented !! !! Keystone command
−
                    [--pass <pass>]  
+
|-
−
                    [--email <email>]
+
|
−
                    [--enabled <true|false>]
+
<source lang="bash">
 +
os user create
 +
    [--password <user-password>]
 +
    [--email <user-email>]
 +
    [--tenant <tenant>]
 +
    [--enable | --disable]
 +
    <user-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-create
 +
    --name <user-name>  
 +
    [--tenant_id <tenant-id>]
 +
    [--pass <pass>]  
 +
    [--email <email>]
 +
    [--enabled <true|false>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user delete
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-delete
 +
    <user-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user list
 +
    [--tenant <tenant>]
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-list
 +
    [<tenant-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user set
 +
    [--name <new-user-name>]
 +
    [--password <user-password>]
 +
    [--email <user-email>]
 +
    [--tenant <tenant>]
 +
    [--enable|--disable]
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-password-update
 +
    --pass <password>
 +
    <user-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user show
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-get
 +
    <user-id>
 +
</source>
 +
|}
  
−
os create user  
+
==== user role ====
−
        [--password <user-password>]
 
−
        [--email <user-email>]
 
−
        [--tenant <tenant>]
 
−
        [--enable | --disable]
 
−
        <user-name>
 
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os user role add
 +
    [--tenant <tenant>]
 +
    <user>
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-role-add
 +
    --user <user-id>
 +
    --role <role-id>
 +
    [--tenant_id <tenant-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user role list
 +
    [--tenant <tenant>]
 +
    [<user>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-role-list
 +
    [--user <user-id>]
 +
    [--tenant_id <tenant-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user role remove
 +
    [--tenant <tenant>]
 +
    <user>
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-role-remove
 +
    --user <user-id>
 +
    --role <role-id>
 +
    [--tenant_id <tenant-id>]
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== <other> ====
−
keystone user-delete <user-id>
 
  
−
os delete user <user>
+
These keystone commands are not planned for re-implementation in OpenStackClient
−
</nowiki></pre>
 
  
−
 
+
<source lang="bash">
−
<pre><nowiki>#!bash
 
−
keystone user-get <user-id>
 
−
 
 
−
os show user <user>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone user-list [<tenant-id>]
 
−
 
 
−
os list user [--tenant <tenant>] [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone user-password-update --pass <password> <user-id>
 
−
 
 
−
os set user
 
−
        [--name <new-user-name>]
 
−
        [--password <user-password>]
 
−
        [--email <user-email>]
 
−
        [--tenant <tenant>]
 
−
        [--enable|--disable]
 
−
        <user>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''user-role'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone user-role-add --user <user-id>
 
−
                      --role <role-id>
 
−
                      [--tenant_id <tenant-id>]
 
−
 
 
−
os add role-user
 
−
        [--tenant <tenant>]
 
−
        <role> <user>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone user-role-list [--user <user-id>]
 
−
                  [--tenant_id <tenant-id>]
 
−
 
 
−
os list role-user
 
−
        [--tenant <tenant>]
 
−
        [<user>]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone user-role-remove --user <user-id>
 
−
                          --role <role-id>
 
−
                          [--tenant_id <tenant-id>]
 
−
 
 
−
os remove role-user
 
−
        [--tenant <tenant>]
 
−
        <role> <user>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''project'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone project-create --name <project-name>
 
−
                      [--domain_id <project-domain-id>]
 
−
                      [--description <project-description>]
 
−
                      [--enabled <true|false>]
 
−
 
 
−
os create project
 
−
        [--domain <project-domain>]
 
−
        [--description <project-description>]
 
−
        [--enable | --disable]
 
−
        <project-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone project-delete <project-id>
 
−
 
 
−
os delete project <project>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone project-get <project-id>
 
−
 
 
−
os show project <project>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone project-list
 
−
 
 
−
os list project [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone project-update
 
−
        [--name <project_name>]
 
−
        [--domain_id <project-domain-id>]
 
−
        [--description <project-description>]
 
−
        [--enabled <true|false>]
 
−
        <project-id>
 
−
 
 
−
os set project
 
−
        [--name <new-project-name>]
 
−
        [--domain <project-domain>]
 
−
        [--description <new-project-description>]
 
−
        [--enable | --disable]
 
−
        <project>
 
−
</nowiki></pre>
 
−
 
 
−
'''group'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone group-create --name <group-name>
 
−
                      [--domain_id <domain-id>]
 
−
                      [--description <group-description>]
 
−
 
 
−
os create group
 
−
        [--domain <domain>]
 
−
        [--description <group-description>]
 
−
        <group-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone group-delete <group-id>
 
−
 
 
−
os delete group <group>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone group-get <group-id>
 
−
 
 
−
os show group <group>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone group-list
 
−
 
 
−
os list group [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone group-update
 
−
        [--name <group_name>]
 
−
        [--domain_id <domain-id>]
 
−
        [--description <group-description>]
 
−
        <group-id>
 
−
 
 
−
os set group
 
−
        [--name <new-group-name>]
 
−
        [--domain <domain>]
 
−
        [--description <new-group-description>]
 
−
        <group>
 
−
</nowiki></pre>
 
−
 
 
−
'''domain'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone domain-create --name <domain-name>
 
−
                      [--description <domain-description>]
 
−
                      [--enabled <true|false>]
 
−
                      [--private_project_names <true|false>]
 
−
                      [--private_user_names <true|false>]
 
−
 
 
−
os create domain
 
−
        [--description <domain-description>]
 
−
        [--enable | --disable]
 
−
        [--private_project_names]
 
−
        [--private_user_names]
 
−
        <domain-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone domain-delete <domain-id>
 
−
 
 
−
os delete domain <domain>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone domain-get <domain-id>
 
−
 
 
−
os show domain <domain>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone domain-list
 
−
 
 
−
os list domain [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone domain-update
 
−
        [--name <domain_name>]
 
−
        [--description <domain-description>]
 
−
        [--enabled <true|false>]
 
−
        [--private_project_names <true|false>]
 
−
        [--private_user_names <true|false>]
 
−
        <domain-id>
 
−
 
 
−
os set domain
 
−
        [--name <new-domain-name>]
 
−
        [--description <new-domain-description>]
 
−
        [--private_project_names]
 
−
        [--private_user_names]
 
−
        [--enable | --disable]
 
−
        <domain>
 
−
</nowiki></pre>
 
−
 
 
−
'''credential'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone credential-create --user_id <user-id>
 
−
                      --type <credential-type>
 
−
                      --data <credential-data>
 
−
                      [--project_id <project-id>]
 
−
 
 
−
os create credential
 
−
        --user <user>
 
−
        --type <credential-type>
 
−
        --data <credential-data>
 
−
        [--project <project>]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone credential-delete <credential-id>
 
−
 
 
−
os delete credential <credential-id>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone credential-get <credential-id>
 
−
 
 
−
os show credential <credential-id>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone credential-list
 
−
 
 
−
os list credential [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone credential-update
 
−
        [--user <user>]
 
−
        [--type <credential-type>]
 
−
        [--data <credential-data>]
 
−
        [--project <project>]
 
−
        <credential-id>
 
−
 
 
−
os set credential
 
−
        [--user_id <user-id>]
 
−
        [--type <credential-type>]
 
−
        [--data <credential-data>]
 
−
        [--project_id <project-id>]
 
−
        <credential-id>
 
−
</nowiki></pre>
 
−
 
 
−
'''policy'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone policy-create --type <policy-type>
 
−
                      --blob <policy-blob>
 
−
 
 
−
os create policy
 
−
        --type <policy-type>
 
−
        --blob <policy-blob>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone policy-delete <policy-id>
 
−
 
 
−
os delete policy <policy-id>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone policy-get <policy-id>
 
−
 
 
−
os show policy <policy-id>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone policy-list
 
−
 
 
−
os list policy [--long]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
keystone policy-update
 
−
        [--type <policy-type>]
 
−
        [--blob <policy-blob>]
 
−
        <policy-id>
 
−
 
 
−
os set policy
 
−
        [--type <policy-type>]
 
−
        [--blob <policy-blob>]
 
−
        <policy-id>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''<other>'''
 
−
 
 
−
<pre><nowiki>#!bash
 
 
keystone bootstrap
 
keystone bootstrap
 
         --pass <password>
 
         --pass <password>
Line 673: Line 919:
 
         [--role-name <role-name>]
 
         [--role-name <role-name>]
 
         [--tenant-name <tenant-name>]
 
         [--tenant-name <tenant-name>]
 +
</source>
  
−
##TBD
+
<source lang="bash">
−
</nowiki></pre>
 
−
 
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
 
keystone discover
 
keystone discover
 +
</source>
  
−
##TBD
+
=== API v3 ===
−
</nowiki></pre>
 
  
 +
==== credential ====
  
−
=== Nova ===
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os credential create
 +
    [--project <project>]
 +
    [--type ec2|cert]
 +
    <user>
 +
    <data>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone credential-create
 +
    --user_id <user-id>
 +
    --type <credential-type>
 +
    --data <credential-data>
 +
    [--project_id <project-id>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os credential delete
 +
    <credential-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone credential-delete
 +
    <credential-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os credential list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone credential-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os credential set
 +
    [--user <user>]
 +
    [--type ec2|cert]
 +
    [--data <data>]
 +
    [--project <project>]
 +
    <credential-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone credential-update
 +
    [--user <user>]
 +
    [--type <type>]
 +
    [--data <data>]
 +
    [--project <project>]
 +
    <credential-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os credential show
 +
    <credential-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone credential-get
 +
    <credential-id>
 +
</source>
 +
|}
  
 +
==== domain ====
  
−
<pre><nowiki>#!csv ,
+
{| class="wikitable"
−
Nova Option, Environment Variable, , OSCLI Option, Environment Variable
+
|-
−
--os-auth-system <auth-system>,OS_AUTH_SYSTEM, ,,
+
! OSC Command !! Implemented !! !! Keystone command
−
--service-type <type>,, ,,
+
|-
−
--service-name <name>,NOVA_SERVICE_NAME, ,,
+
|
−
--volume-service-name <name>,NOVA_VOLUME_SERVICE_NAME, ,,
+
<source lang="bash">
−
--endpoint-type <type>,NOVA_ENDPOINT_TYPE, ,,
+
os domain create
−
--os-compute-api-version <ver>,OS_COMPUTE_API_VERSION, ,--os-compute-api-version <ver>,OS_COMPUTE_API_VERSION
+
    [--description <domain-description>]
−
--bypass-url <bypass-url>,, ,,
+
    [--enable | --disable]
−
</nowiki></pre>
+
    <domain-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone domain-create
 +
    --name <domain-name>
 +
    [--description <domain-description>]
 +
    [--enabled <true|false>]
 +
    [--private_project_names <true|false>]
 +
    [--private_user_names <true|false>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os domain delete
 +
    <domain>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone domain-delete
 +
    <domain-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os domain list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone domain-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os domain set
 +
    [--name <new-domain-name>]
 +
    [--description <new-domain-description>]
 +
    [--enable | --disable]
 +
    <domain>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone domain-update
 +
    [--name <domain_name>]
 +
    [--description <domain-description>]
 +
    [--enabled <true|false>]
 +
    [--private_project_names <true|false>]
 +
    [--private_user_names <true|false>]
 +
    <domain-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os domain show
 +
    <domain>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone domain-get
 +
    <domain-id>
 +
</source>
 +
|}
  
 +
==== endpoint ====
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint create
 +
    [--region <endpoint-region>
 +
    [--enable | --disable]
 +
    <service>
 +
    <interface admin|public|internal>
 +
    <url>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-create
 +
    [--region <endpoint-region>
 +
    [--enable | --disable]
 +
    <service_id>
 +
    <interface admin|public|internal>
 +
    <url>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint delete
 +
    <endpoint-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint set
 +
    [--interface <endpoint-interface>]
 +
    [--url <endpoint-url>]
 +
    [--service <service-id>]
 +
    [--region <endpoint-region>]
 +
    [--enable | --disable]
 +
    <endpoint>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-set
 +
    [--interface <endpoint-interface>]
 +
    [--url <endpoint-url>]
 +
    [--service <service-id>]
 +
    [--region <endpoint-region>]
 +
    [--enable | --disable]
 +
    <endpoint>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint show
 +
    <endpoint>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone endpoint-get
 +
    <endpoint>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== group ====
−
nova actions <server>
 
  
−
##TBD
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os group create
 +
    [--domain <domain>]
 +
    [--description <group-description>]
 +
    <group-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone group-create
 +
    --name <group-name>
 +
    [--domain_id <domain-id>]
 +
    [--description <group-description>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os group delete
 +
    <group>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone group-delete
 +
    <group-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os group list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone group-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os group set
 +
    [--name <new-group-name>]
 +
    [--domain <domain>]
 +
    [--description <new-group-description>]
 +
    <group>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone group-update
 +
    [--name <group_name>]
 +
    [--domain_id <domain-id>]
 +
    [--description <group-description>]
 +
    <group-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os group show
 +
    <group>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone group-get
 +
    <group-id>
 +
</source>
 +
|}
  
 +
==== oauth ====
  
−
'''aggregate'''
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os access token create
 +
    --consumer-key <consumer-key>
 +
    --consumer-secret <consumer-secret>
 +
    --request-key <request-key>
 +
    --request-secret <request-secret>
 +
    --verifier <pin>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
n/a
 +
</source>
 +
|-
 +
| look at some alternatives: || || ||
 +
|-
 +
|
 +
<source lang="bash">
 +
os oauth token create
 +
    --consumer-key <consumer-key>
 +
    --consumer-secret <consumer-secret>
 +
    --request-key <request-key>
 +
    --request-secret <request-secret>
 +
    --verifier <pin>
 +
</source>
 +
|| nyet
 +
|| ||
 +
<source lang="bash">
 +
* makes the token specific to oauth
 +
* add [--oauth-ver X] if versioning for oauth2 is an issue?
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os oauth token create
 +
    --access
 +
    --consumer-key <consumer-key>
 +
    --consumer-secret <consumer-secret>
 +
    --request-key <request-key>
 +
    --request-secret <request-secret>
 +
    --verifier <pin>
  
−
<pre><nowiki>#!bash
+
os oauth token create
−
nova aggregate-create <name> <availability_zone>
+
    --request
 +
    --consumer-key <consumer-key>
 +
    --roles <roles>
 +
</source>
 +
|| nyet
 +
|| ||
 +
<source lang="bash">
 +
* collapse 'access token' and 'request token' into 'oauth token'?
 +
</source>
 +
|}
  
−
os create aggregate ...
+
==== policy ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os policy create
 +
    [--type <policy-type>]
 +
    --blob-file <blob-file>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone policy-create
 +
    --type <policy-type>
 +
    --blob <policy-blob>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os policy delete
 +
    <policy-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone policy-delete
 +
    <policy-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os policy list
 +
    [--include-blob]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone policy-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os policy set
 +
    [--type <policy-type>]
 +
    [--blob-file<blob-file>]
 +
    <policy-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone policy-update
 +
    [--type <policy-type>]
 +
    [--blob <policy-blob>]
 +
    <policy-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os policy show
 +
    <policy-id>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone policy-get
 +
    <policy-id>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== project ====
−
nova aggregate-delete <id>
 
  
−
os delete aggregate ...
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os project create
 +
    [--domain <project-domain>]
 +
    [--description <project-description>]
 +
    [--enable | --disable]
 +
    <project-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone project-create
 +
    [--domain_id <domain_id>]
 +
    [--description <description>]
 +
    [--enable | --disable]
 +
    <name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os project delete
 +
    <project>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
os project-delete
 +
    <project_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os project list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone project-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os project set
 +
    [--name <new-project-name>]
 +
    [--domain <project-domain>]
 +
    [--description <new-project-description>]
 +
    [--enable | --disable]
 +
    <project>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone project-set
 +
    [--name <new-project-name>]
 +
    [--domain <project-domain>]
 +
    [--description <new-project-description>]
 +
    [--enable | --disable]
 +
    <project_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os project show
 +
    <project>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone project-get
 +
    <project_id>
 +
</source>
 +
|}
  
 +
==== role ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova aggregate-details <id>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os role add
 +
    [--user <user> | --group <group>]
 +
    [--domain <domain> | --project <project>]
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role create
 +
    <role-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role delete
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role remove
 +
    [--user <user> | --group <group>]
 +
    [--domain <domain> | --project <project>]
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role set
 +
    [--name <new-role-name>]
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os role show
 +
    <role>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|}
  
−
os show aggregate ...
+
==== service ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os service create
 +
[--name <name>]
 +
        [--enabled <true|false>]
 +
        <type>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-create
 +
[--name <name>]
 +
        [--enabled <true|false>]
 +
        <type>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service delete
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-delete
 +
    <service_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os list service
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service set
 +
    [--type <service-type>]
 +
    [--name <new-name>]
 +
    [--enable | --disable]
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-set
 +
    [--type <service-type>]
 +
    [--name <new-name>]
 +
    [--enable | --disable]
 +
    <service>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os service show
 +
    <service>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone service-get
 +
    <service_id>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== user ====
−
nova aggregate-list
 
−
 
 
−
os list aggregate
 
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os user create
 +
    [--password <password>]
 +
    [--project <project>]
 +
    [--email <user-email>]
 +
    [--enable | --disable]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-create
 +
    --name <user-name>
 +
    [--domain_id <domain-id>]
 +
    [--default_project_id <project-id>]
 +
    [--description <description>]
 +
    [--enabled <true|false>]
 +
    [--password <password>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user delete
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-delete
 +
    <user-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user list
 +
    [--project <project>]
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user set
 +
    [--name <new-name>]
 +
    [--password <password>]
 +
    [--project <project>]
 +
    [--email <user-email>]
 +
    [--enable | --disable]
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-update
 +
    --user_id <user-id>
 +
    [--name <user-name>]
 +
    [--domain_id <domain-id>]
 +
    [--default_project_id <project-id>]
 +
    [--description <description>]
 +
    [--enabled <true|false>]
 +
    [--password <password>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os user show
 +
    <user>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
keystone user-get
 +
    <user-id>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
== Compute ==
−
nova aggregate-update <id> <name> [<availability_zone>]
 
  
−
os set aggregate ...
 
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Option !! Environment Variable !! !! Nova Option !! Environment Variable
 +
|-
 +
| || || || --os-auth-system <auth-system> || OS_AUTH_SYSTEM
 +
|-
 +
| || || || --service-type <type> ||
 +
|-
 +
| || || || --service-name <name> || NOVA_SERVICE_NAME
 +
|-
 +
| || || || --volume-service-name <name> || NOVA_VOLUME_SERVICE_NAME
 +
|-
 +
| || || || --endpoint-type <type> || NOVA_ENDPOINT_TYPE
 +
|-
 +
| --os-compute-api-version <ver> || OS_COMPUTE_API_VERSION || || --os-compute-api-version <ver> || OS_COMPUTE_API_VERSION
 +
|-
 +
| || || || --bypass-url <bypass-url> ||
 +
|}
  
−
<pre><nowiki>#!bash
 
−
nova aggregate-set-metadata <id> <key=value> [<key=value> ...]
 
  
−
os set aggregate --metadata ...
+
=== API v2 (1.1) ===
−
</nowiki></pre>
 
  
 +
==== agent ====
  
−
'''aggregate-host'''
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os agent create
 +
    <os>
 +
    <architecture>
 +
    <version>
 +
    <url>
 +
    <md5hash>
 +
    <hypervisor>
 +
</source>
 +
|| yes
 +
|| ||
 +
|-
 +
|
 +
<source lang="bash">
 +
os agent delete
 +
    <id>
 +
</source>
 +
|| yes
 +
|| ||
 +
|-
 +
|
 +
<source lang="bash">
 +
os agent list
 +
    [--hypervisor <hypervisor>]
 +
</source>
 +
|| yes
 +
|| ||
 +
|-
 +
|
 +
<source lang="bash">
 +
os agent set
 +
    <id>
 +
    <version>
 +
    <url>
 +
    <md5hash>
 +
</source>
 +
|| yes
 +
|| ||
 +
|}
  
−
<pre><nowiki>#!bash
 
−
nova aggregate-add-host <id> <host>
 
  
−
os add aggregate-host ...
+
==== aggregate ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate add host
 +
    <aggregate>
 +
    <host>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-add-host
 +
    <id>
 +
    <host>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate create
 +
    [--zone <availability-zone>]
 +
    [--property <key=value>]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-create
 +
    <name>
 +
    [<availability_zone>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate delete
 +
    <aggregate>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-delete
 +
    <id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate remove host
 +
    <aggregate>
 +
    <host>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-remove-host
 +
    <id>
 +
    <host>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate set
 +
    [--name <new-name>]
 +
    [--zone <availability-zone>]
 +
    [--property <key=value>]
 +
    <aggregate>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-update
 +
    <id>
 +
    <name>
 +
    [<availability_zone>]
  
−
<pre><nowiki>#!bash
+
nova aggregate-set-metadata
−
nova aggregate-remove-host <id> <host>
+
    <id>
−
 
+
    <key=value>
−
os remove aggregate-host ...
+
    [<key=value> ...]
−
</nowiki></pre>
+
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os aggregate show
 +
    <aggregate>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova aggregate-details
 +
    <id>
 +
</source>
 +
|}
  
 +
==== bash-completion ====
  
−
'''bash-completion'''
+
{| class="wikitable"
−
 
+
|-
−
<pre><nowiki>#!bash
+
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
TBD
 +
|| no
 +
|| ||
 +
<source lang="bash">
 
nova bash-completion
 
nova bash-completion
 +
</source>
 +
|}
  
−
os show bash-completion
+
==== cloudpipe ====
−
</nowiki></pre>
 
  
−
 
+
{| class="wikitable"
−
'''cloudpipe'''
+
|-
−
 
+
! OSC Command !! Implemented !! !! Nova command
−
<pre><nowiki>#!bash
+
|-
−
nova cloudpipe-create <project>
+
|
−
 
+
<source lang="bash">
−
os create cloudpipe ...
+
os create cloudpipe
−
</nowiki></pre>
+
    <project>
−
 
+
</source>
−
 
+
|| no
−
<pre><nowiki>#!bash
+
|| ||
 +
<source lang="bash">
 +
nova cloudpipe-create
 +
    <project>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os list cloudpipe
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 
nova cloudpipe-list
 
nova cloudpipe-list
 +
</source>
 +
|}
  
−
os list cloudpipe
+
==== console ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os console log show
 +
    [--lines <num-lines>]
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova console-log
 +
    [--length <length>]
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os console url show
 +
    [--novnc | --xvpvnc | --spice]
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova get-vnc-console
 +
    <server>
 +
    <console_type>
 +
</source>
 +
|}
  
−
'''console'''
+
==== credentials ====
  
−
<pre><nowiki>#!bash
+
See [[#credentials|credentials]] in the [[#Cross_API|cross API section]].
−
nova console-log [--length <length>] <server>
 
  
−
os show console ...
+
==== diagnostics ====
−
</nowiki></pre>
 
  
 +
''Consider implementing this as: show server --diagnostics <server>''
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os diagnostics show
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova diagnostics
 +
    <server>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== dns ====
−
nova get-vnc-console <server> <console_type>
 
  
−
os show console [--vnc] ...
+
''These commands need some attention...an IP shouldn't be required for all record types.  They need to be more DNS-y.  Zone anyone?''
−
</nowiki></pre>
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os create dns
 +
    [--type <type>]
 +
    <ip>
 +
    <name>
 +
    <domain>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova dns-create
 +
    [--type <type>]
 +
    <ip>
 +
    <name>
 +
    <domain>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os delete dns
 +
    <domain>
 +
    <name>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova dns-delete
 +
    <domain>
 +
    <name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os list dns
 +
    [--ip <ip>]
 +
    [--name <name>]
 +
    <domain>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova dns-list
 +
    [--ip <ip>]
 +
    [--name <name>]
 +
    <domain>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os create dns-domain
 +
    [--project <project>]
 +
    [--availability-zone <availability-zone>]
 +
    [--public | --private]
 +
    <domain>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova dns-create-private-domain
 +
    [--availability_zone <availability_zone>]
 +
    <domain>
  
−
 
+
nova dns-create-public-domain
−
'''credentials'''
+
    [--project <project>]
−
 
+
    <domain>
−
<pre><nowiki>#!bash
+
</source>
−
nova credentials
+
|-
−
 
+
|
−
os show credentials
+
<source lang="bash">
−
</nowiki></pre>
+
os delete dns-domain
−
 
+
    <domain>
−
 
+
</source>
−
'''diagnostics'''
+
|| no
−
 
+
|| ||
−
<pre><nowiki>#!bash
+
<source lang="bash">
−
nova diagnostics <server>
+
nova dns-delete-domain
−
 
+
    <domain>
−
os show diagnostics ...
+
</source>
−
</nowiki></pre>
+
|-
−
 
+
|
−
 
+
<source lang="bash">
−
'''dns'''
+
os list dns-domains
−
 
+
</source>
−
<pre><nowiki>#!bash
+
|| no
−
nova dns-create [--type <type>] <ip> <name> <domain>
+
|| ||
−
 
+
<source lang="bash">
−
os create dns ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova dns-delete <domain> <name>
 
−
 
 
−
os delete dns ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova dns-list [--ip <ip>] [--name <name>] <domain>
 
−
 
 
−
os list dns ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''dns-domain'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova dns-create-private-domain [--availability_zone <availability_zone>]
 
−
                              <domain>
 
−
 
 
−
os create dns-domain [--private] ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''dns-public-domain'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova dns-create-public-domain [--project <project>] <domain>
 
−
 
 
−
os create dns-domain [--public] ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova dns-delete-domain <domain>
 
−
 
 
−
os delete dns-domain ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
 
nova dns-domains
 
nova dns-domains
 +
</source>
 +
|}
  
−
os list dns-domains
+
==== endpoints ====
−
</nowiki></pre>
 
−
 
 
  
−
'''endpoints'''
+
''Totally duplicates Identity catalog command''
−
 
+
{| class="wikitable"
−
<pre><nowiki>#!bash
+
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os endpoint list
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 
nova endpoints
 
nova endpoints
 +
</source>
 +
|}
  
−
os list endpoints
+
==== fixed-ip ====
−
 
 
−
# does this overlap with keystone?
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''fixed-ip'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova add-fixed-ip <server> <network_id>
 
−
 
 
−
os add fixed-ip ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova remove-fixed-ip <server> <address>
 
−
 
 
−
os remove fixed-ip ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''flavor'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova flavor-create [--ephemeral <ephemeral>]
 
−
                  [--swap <swap>]
 
−
                  [--rxtx-factor <factor>]
 
−
                  <name> <id> <ram> <disk> <vcpus>
 
−
 
 
−
os create flavor ...
 
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip fixed add
 +
    <network>
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova add-fixed-ip
 +
    <server>
 +
    <network_id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip fixed remove
 +
    <ip-address>
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova remove-fixed-ip
 +
    <server>
 +
    <address>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
 
−
nova flavor-delete <id>
 
  
−
os delete flavor ...
+
==== flavor ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os flavor create
 +
    [--id <id>]
 +
    [--ram <size-mb>]
 +
    [--disk <size-gb>]
 +
    [--ephemeral-disk <size-gb>]
 +
    [--swap <size-mb>]
 +
    [--vcpus <num-cpu>]
 +
    [--rxtx-factor <factor>]
 +
    [--public | --private]
 +
    <name>
 +
</source>
 +
||
 +
<source lang="bash">
 +
(partial)
 +
default: auto
 +
default: 256M
 +
default: 0G
 +
default: 0G
 +
default: 0G
 +
default: 1
 +
default: 1
 +
default: public
  
−
<pre><nowiki>#!bash
+
</source>
 +
|| ||
 +
<source lang="bash">
 +
nova flavor-create
 +
    [--ephemeral <ephemeral>]
 +
    [--swap <swap>]
 +
    [--rxtx-factor <factor>]
 +
    <name>
 +
    <id>
 +
    <ram>
 +
    <disk>
 +
    <vcpus>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os flavor delete
 +
    <flavor>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova flavor-delete
 +
    <id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os flavor list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
nova flavor-list
 
nova flavor-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os flavor show
 +
    <flavor>
 +
</source>
 +
|| yes
 +
|| ||
 +
|}
  
−
os list flavor
 
−
</nowiki></pre>
 
−
 
−
 
−
'''floating-ip'''
 
−
 
−
<pre><nowiki>#!bash
 
−
nova add-floating-ip <server> <address>
 
−
 
−
os add floating-ip ...
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova floating-ip-create [<floating_ip_pool>]
 
−
 
−
os create floating-ip ...
 
−
</nowiki></pre>
 
  
 +
==== floating-ip ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova floating-ip-delete <address>
+
|-
−
 
+
! OSC Command !! Implemented !! !! Nova command
−
os delete floating-ip
+
|-
−
</nowiki></pre>
+
|
−
 
+
<source lang="bash">
−
 
+
os ip floating add
−
<pre><nowiki>#!bash
+
    <ip-address>
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova add-floating-ip
 +
    <server>
 +
    <address>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip floating create
 +
    [<pool>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova floating-ip-create
 +
    [<floating_ip_pool>]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip floating delete
 +
    <ip-address>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova floating-ip-delete
 +
    <address>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip floating list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
nova floating-ip-list
 
nova floating-ip-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip floating remove
 +
    <ip-address>
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova remove-floating-ip
 +
    <server>
 +
    <address>
 +
</source>
 +
|}
  
−
os list floating-ip
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova remove-floating-ip <server> <address>
 
−
 
−
os remove floating-ip ...
 
−
</nowiki></pre>
 
  
 +
==== floating-ip-pool ====
  
−
'''floating-ip-pool'''
 
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os ip floating pool list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
nova floating-ip-pool-list
 
nova floating-ip-pool-list
 +
</source>
 +
|}
  
−
os list floating-ip-pool
 
−
</nowiki></pre>
 
−
 
−
 
−
'''host'''
 
−
 
−
<pre><nowiki>#!bash
 
−
nova host-action [--action <action>] <hostname>
 
−
 
−
os ?? host ...
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova host-update [--status <status>]
 
−
                [--maintenance <maintenance_mode>]
 
−
                <hostname>
 
−
 
−
os set host ...
 
−
</nowiki></pre>
 
−
 
−
 
−
'''image'''
 
−
 
−
<pre><nowiki>#!bash
 
−
nova image-create [--poll] <server> <name>
 
−
 
−
os create image ...
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova image-delete <image>
 
−
 
−
os delete image ...
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova image-list
 
−
 
−
os list image
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova image-meta <image> <action> <key=value> [<key=value> ...]
 
−
 
−
os set image ...
 
−
</nowiki></pre>
 
−
 
−
 
−
<pre><nowiki>#!bash
 
−
nova image-show <image>
 
  
−
os show image ...
+
==== host ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os host list
 +
    [--zone <availability-zone>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova host-action
 +
    [--action <action>]
 +
    <hostname>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os host set
 +
    ...
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova host-update
 +
    [--status <status>]
 +
    [--maintenance <maintenance_mode>]
 +
    <hostname>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os host show
 +
    <host>
 +
</source>
 +
|| yes
 +
|| ||
 +
|}
  
−
'''keypair'''
 
  
−
<pre><nowiki>#!bash
+
==== hypervisor ====
−
nova keypair-add [--pub_key <pub_key>] <name>
 
  
−
os create keypair ...
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os hypervisor list
 +
    [--matching <hostname>]
 +
</source>
 +
|| yes
 +
|| ||
 +
|-
 +
|
 +
<source lang="bash">
 +
os hypervisor show
 +
    <id>
 +
</source>
 +
|| yes
 +
|| ||
 +
|}
  
  
−
<pre><nowiki>#!bash
+
==== keypair ====
−
nova keypair-delete <name>
 
  
−
os delete keypair
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
−
 
+
! OSC Command !! Implemented !! !! Nova command
−
 
+
|-
−
<pre><nowiki>#!bash
+
|
 +
<source lang="bash">
 +
os keypair create
 +
    [--public-key <file>]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova keypair-add
 +
    [--pub_key <pub_key>]
 +
    <name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os keypair delete
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova keypair-delete
 +
    <name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os keypair list
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 
nova keypair-list
 
nova keypair-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os keypair show
 +
    [--public-key]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
|}
  
−
os list keypair
 
−
</nowiki></pre>
 
  
 +
==== limits ====
  
−
'''limits'''
+
See [[#limits|limits]] in the [[#Cross_API|cross API section]].
  
−
<pre><nowiki>#!bash
+
==== quota ====
−
nova absolute-limits
 
  
−
os show limits --absolute
+
See [[#quota|quota]] in the [[#Cross_API|cross API section]].
−
## is there any other kind?
 
−
</nowiki></pre>
 
  
  
−
'''quota'''
+
==== resource ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova quota-defaults <tenant_id>
+
|-
−
nova quota-show <tenant_id>
+
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os show resource
 +
    <hostname>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova describe-resource
 +
    <hostname>
 +
</source>
 +
|}
  
−
os show quota <tenant> [--defaults]
+
==== secgroup ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup add
  
−
<pre><nowiki>#!bash
+
(see server add secgroup)
−
nova quota-update [--instances <instances>]
+
</source>
−
                  [--cores <cores>]
+
|| no
−
                  [--ram <ram>]
+
|| ||
−
                  [--volumes <volumes>]
+
<source lang="bash">
−
                  [--gigabytes <gigabytes>]
+
nova add-secgroup
−
                  [--floating-ips <floating_ips>]
+
    <server>
−
                  [--metadata-items <metadata_items>]
+
    <secgroup>
−
                  [--injected-files <injected_files>]
+
</source>
−
                  [--injected-file-content-bytes <injected_file_content_bytes>]
+
|-
−
                  <tenant_id>
+
|
−
 
+
<source lang="bash">
−
os set quota ...
+
os secgroup create
−
</nowiki></pre>
+
    [--description <description>]
−
 
+
    <name>
−
 
+
</source>
−
'''quota-class'''
+
|| yes
−
 
+
|| ||
−
<pre><nowiki>#!bash
+
<source lang="bash">
−
nova quota-class-show <class>
+
nova secgroup-create
−
 
+
    <name>
−
os show quota-class ...
+
    <description>
−
</nowiki></pre>
+
</source>
−
 
+
|-
−
 
+
|
−
<pre><nowiki>#!bash
+
<source lang="bash">
−
nova quota-class-update [--instances <instances>]  
+
os secgroup delete
−
                        [--cores <cores>]
+
    <group>
−
                        [--ram <ram>]
+
</source>
−
                        [--volumes <volumes>]
+
|| yes
−
                        [--gigabytes <gigabytes>]
+
|| ||
−
                        [--floating-ips <floating_ips>]
+
<source lang="bash">
−
                        [--metadata-items <metadata_items>]
+
nova secgroup-delete
−
                        [--injected-files <injected_files>]
+
    <secgroup>
−
                        [--injected-file-content-bytes <injected_file_content_bytes>]
+
</source>
−
                        <class>
+
|-
−
 
+
|
−
os set quota-class ...
+
<source lang="bash">
−
</nowiki></pre>
+
os secgroup list
−
 
+
    [--all-projects]
−
 
+
</source>
−
'''rate-limits'''
+
|| yes
−
 
+
|| ||
−
<pre><nowiki>#!bash
+
<source lang="bash">
−
nova rate-limits
 
−
 
 
−
os show rate-limits
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''resource'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova describe-resource <hostname>
 
−
 
 
−
os show resource ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''secgroup'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova secgroup-create <name> <description>
 
−
 
 
−
os create secgroup ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova secgroup-delete <secgroup>
 
−
 
 
−
os delete secgroup ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
 
nova secgroup-list
 
nova secgroup-list
 +
    [--all-tenants [<0|1>]]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup remove
  
−
os list secgroup
+
(see server remove secgroup)
−
</nowiki></pre>
+
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova remove-secgroup
 +
    <server>
 +
    <secgroup>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup set
 +
    [--name <new-name>]
 +
    [--description [<new-description>]
 +
    <group>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-update
 +
    <secgroup>
 +
    <name>
 +
    <description>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup show
 +
    <group>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
n/a
 +
</source>
 +
|}
  
 +
==== secgroup-group-rule ====
  
−
'''secgroup-group-rule'''
+
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup group rule create
 +
    [--proto <protocol>]
 +
    [--port <port>:<port>]
 +
    <source-group>
 +
    <secgroup>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-add-group-rule
 +
    [--ip_proto <ip_proto>]
 +
    [--from_port <from_port>]
 +
    [--to_port <to_port>]
 +
    <secgroup>
 +
    <source_group>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup group rule delete
 +
    [--proto <protocol>]
 +
    [--port <port>:<port>]
 +
    <source-group>
 +
    <secgroup>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-delete-group-rule
 +
    [--ip_proto <ip_proto>]
 +
    [--from_port <from_port>]
 +
    [--to_port <to_port>]
 +
    <secgroup>
 +
    <source_group>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== secgroup-rule ====
−
nova secgroup-add-group-rule [--ip_proto <ip_proto>]
 
−
                            [--from_port <from_port>]
 
−
                            [--to_port <to_port>]
 
−
                            <secgroup> <source_group>
 
  
−
os create secgroup-group-rule
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Nova command
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup rule create
 +
    [--proto <proto>]
 +
    [--src-ip <ip-address>]
 +
    [--dst-port <port-range>]
 +
    <group>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-add-rule
 +
    <secgroup>
 +
    <ip_proto>
 +
    <from_port>
 +
    <to_port>
 +
    <cidr>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup rule delete
 +
    [--proto <proto>]
 +
    [--src-ip <ip-address>]
 +
    [--dst-port <port-range>]
 +
    <group>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-delete-rule
 +
    <secgroup>
 +
    <ip_proto>
 +
    <from_port>
 +
    <to_port>
 +
    <cidr>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os secgroup rule list
 +
    <group>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova secgroup-list-rules
 +
    <secgroup>
 +
</source>
 +
|}
  
 +
====server====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova secgroup-delete-group-rule [--ip_proto <ip_proto>]
+
|-
−
                                [--from_port <from_port>]
+
! OSC Command !! Implemented !! !! Nova command
−
                                [--to_port <to_port>]
+
|-
−
                                <secgroup> <source_group>
+
|
 +
<source lang="bash">
 +
os server add secgroup
 +
    <server>
 +
    <group>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova add-secgroup
 +
    <server>
 +
    <secgroup>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server create
 +
    --image <image>
 +
    --flavor <flavor>
 +
    [--security-group <security-group-list> [...] ]
 +
    [--key-name <key-name>]
 +
    [--meta-data <key=value> [...] ]
 +
    [--file <dest-filename=source-filename>] [...] ]
 +
    [--user-data <user-data>]
 +
    [--availability-zone <zone-name>]
 +
    [--block-device-mapping <dev-name=mapping> [...] ]
 +
    [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr> [...] ]
 +
    [--hint <key=value> [...] ]
 +
    [--config-drive <value>|True ]
 +
    [--min <count>]
 +
    [--max <count>]
 +
    [--wait]
 +
    <server-name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova boot
 +
    [--flavor <flavor>]
 +
    [--image <image>]
 +
    [--meta <key=value>]
 +
    [--file <dst-path=src-path>]
 +
    [--key_name <key_name>]
 +
    [--user_data <user-data>]
 +
    [--availability_zone <availability-zone>]
 +
    [--security_groups <security_groups>]
 +
    [--block_device_mapping <dev_name=mapping>]
 +
    [--hint <key=value>]
 +
    [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr>]
 +
    [--config-drive <value>]
 +
    [--poll]
 +
    <name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server delete
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova delete
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server list
 +
    [--reservation-id <reservation-id>]
 +
    [--ip <ip-regex>]
 +
    [--ip6 <ip6-regex>]
 +
    [--name <name-regex>]
 +
    [--instance-name <instance-name-regex>]
 +
    [--status <status>]
 +
    [--flavor <flavor>]
 +
    [--image <image>]
 +
    [--host <hostname>]
 +
    [--all-tenants]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova list
 +
    [--reservation_id <reservation_id>]
 +
    [--ip <ip_regexp>]
 +
    [--ip6 <ip6_regexp>]
 +
    [--name <name_regexp>]
 +
    [--instance_name <name_regexp>]
 +
    [--status <status>]
 +
    [--flavor <flavor>] [--image <image>]  
 +
    [--host <hostname>]
 +
    [--all_tenants [<0|1>]]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server lock
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova lock
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server migrate
 +
    --live
 +
    [--block_migrate]
 +
    [--disk_over_commit]
 +
    <server>
 +
    <host>
  
−
os delete secgroup-group-rule ...
+
os server migrate
−
</nowiki></pre>
+
    [--wait]
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova live-migration
 +
    [--block_migrate]
 +
    [--disk_over_commit]
 +
    <server>
 +
<host>
  
−
 
+
nova migrate
−
'''secgroup-rule'''
+
    [--poll]
−
 
+
    <server>
−
<pre><nowiki>#!bash
+
</source>
−
nova secgroup-add-rule <secgroup> <ip_proto> <from_port> <to_port> <cidr>
+
|-
−
 
+
|
−
os create secgroup-rule
+
<source lang="bash">
−
</nowiki></pre>
+
os server pause
−
 
+
    <server>
−
 
+
</source>
−
<pre><nowiki>#!bash
+
|| yes
−
nova secgroup-delete-rule <secgroup> <ip_proto> <from_port> <to_port> <cidr>
+
|| ||
−
 
+
<source lang="bash">
−
os delete secgroup-rule
+
nova pause
−
</nowiki></pre>
+
    <server>
−
 
+
</source>
−
 
+
|-
−
<pre><nowiki>#!bash
+
|
−
nova secgroup-list-rules <secgroup>
+
<source lang="bash">
−
 
+
os server reboot
−
os list secgroup-rule ...
+
    [--hard | --soft]
−
</nowiki></pre>
+
    [--wait]
−
 
+
    <server>
−
 
+
</source>
−
'''server'''
+
|| yes
−
 
+
|| ||
−
<pre><nowiki>#!bash
+
<source lang="bash">
−
nova boot [--flavor <flavor>]
+
nova reboot
−
          [--image <image>]
+
    [--hard]
−
          [--meta <key=value>]
+
    [--poll]
−
          [--file <dst-path=src-path>]
+
    <server>
−
          [--key_name <key_name>]
+
</source>
−
          [--user_data <user-data>]
+
|-
−
          [--availability_zone <availability-zone>]
+
|
−
          [--security_groups <security_groups>]
+
<source lang="bash">
−
          [--block_device_mapping <dev_name=mapping>]
+
os server rebuild
−
          [--hint <key=value>]
+
    --image <image>
−
          [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr>]
+
    [--password <password>]  
−
          [--config-drive <value>]
+
    [--wait]
−
          [--poll]
+
    <server>
−
          <name>
+
</source>
−
 
+
|| yes
−
os create server
+
|| ||
−
          --image <image>
+
<source lang="bash">
−
          --flavor <flavor>
+
nova rebuild
−
          [--security-group <security-group-list> [...] ]
+
    [--rebuild_password <rebuild_password>]  
−
          [--key-name <key-name>]
+
    [--poll]
−
          [--meta-data <key=value> [--meta-data <key=value] [...] ]
+
    <server>
−
          [--file <dest-filename=source-filename> [--file <dest-filename=source-filename>] [...] ]
+
    <image>
−
          [--user-data <user-data>]
+
</source>
−
          [--reservation-id <uuid>]
+
|-
−
          [--availability-zone <zone-name>]
+
|
−
          [--block-device-mapping <dev-name=mapping> [...] ]
+
<source lang="bash">
−
          [--nic <net-id=net-uuid,v4-fixed-ip=ip-addr> [...] ]
+
os server remove secgroup
−
          [--hint <key=value> [...] ]
+
    <server>
−
          [--config-drive <value>|True ]
+
    <group>
−
          [--min <count>]
+
</source>
−
          [--max <count>]
+
|| no
−
          [--wait]
+
|| ||
−
          <server-name>
+
<source lang="bash">
−
</nowiki></pre>
+
nova remove-secgroup
−
 
+
    <server>
−
 
+
    <secgroup>
−
<pre><nowiki>#!bash
+
</source>
−
nova delete <server>
+
|-
−
 
+
|
−
os delete server <server>
+
<source lang="bash">
−
</nowiki></pre>
+
os server rename
−
 
+
    <server>
−
 
+
    <new-name>
−
 
+
</source>
−
<pre><nowiki>#!bash
+
|| no
−
nova list [--reservation_id <reservation_id>]
+
|| ||
−
          [--ip <ip_regexp>]
+
<source lang="bash">
−
          [--ip6 <ip6_regexp>]
+
nova rename
−
          [--name <name_regexp>]
+
    <server>
−
          [--instance_name <name_regexp>]
+
    <name>
−
          [--status <status>]
+
</source>
−
          [--flavor <flavor>] [--image <image>]
+
|-
−
          [--host <hostname>]
+
|
−
          [--all_tenants [<0|1>]]
+
<source lang="bash">
−
 
+
os server rescue
−
os list server  
+
    <server>
−
          [--reservation-id <reservation-id>]
+
</source>
−
          [--ip <ip-regex>]
+
|| no
−
          [--ip6 <ip6-regex>]
+
|| ||
−
          [--name <name-regex>]
+
<source lang="bash">
−
          [--instance-name <instance-name-regex>]
+
nova rescue
−
          [--status <status>]
+
    <server>
−
          [--flavor <flavor>]
+
</source>
−
          [--image <image>]
+
|-
−
          [--host <hostname>]
+
|
−
          [--all-tenants]
+
<source lang="bash">
−
</nowiki></pre>
+
os server resize
−
 
+
    --flavor <flavor>
−
 
+
    [--wait]
−
<pre><nowiki>#!bash
+
    <server>
−
nova lock <server>
+
</source>
−
 
+
|| no
−
os lock server <server>
+
|| ||
−
</nowiki></pre>
+
<source lang="bash">
−
 
+
nova resize
−
 
+
    [--poll]
−
<pre><nowiki>#!bash
+
    <server>
−
nova live-migration [--block_migrate]
+
    <flavor>
−
                    [--disk_over_commit]
+
</source>
−
                    <server> <host>
+
|-
−
nova migrate [--poll] <server>
+
|
−
 
+
<source lang="bash">
−
os migrate server --live
+
os server resize
−
          [--block_migrate]
+
    --confirm
−
          [--disk_over_commit]
+
    <server>
−
          <server>
+
</source>
−
          <host>
+
|| no
−
os migrate server [--wait] <server>
+
|| ||
−
</nowiki></pre>
+
<source lang="bash">
−
 
+
nova resize-confirm
−
 
+
    <server>
−
<pre><nowiki>#!bash
+
</source>
−
nova pause <server>
+
|-
−
 
+
|
−
os pause server <server>
+
<source lang="bash">
−
</nowiki></pre>
+
os server resume
−
 
+
    <server>
−
 
+
</source>
−
<pre><nowiki>#!bash
+
|| yes
−
nova reboot [--hard] [--poll] <server>
+
|| ||
−
 
+
<source lang="bash">
−
os reboot server [--hard|--soft] [--wait] <server>
+
nova resume
−
</nowiki></pre>
+
    <server>
−
 
+
</source>
−
 
+
|-
−
<pre><nowiki>#!bash
+
|
−
nova rebuild [--rebuild_password <rebuild_password>]
+
<source lang="bash">
−
            [--poll]
+
os server set
−
            <server> <image>
+
    --meta-data <key=value>
−
 
+
    [--meta-data <key=value>] ...
−
os rebuild server  
+
    <server>
−
          --image <image>
 
−
          [--rebuild-password <rebuild-password>]
 
−
          [--wait]
 
−
          <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova rename <server> <name>
 
−
 
 
−
os rename server <server> <new-name>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova rescue <server>
 
−
 
 
−
os rescue server <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova resize [--poll] <server> <flavor>
 
−
 
 
−
os resize server --flavor <flavor> [--wait] <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova resize-confirm <server>
 
−
 
 
−
os resize server --confirm <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova resume <server>
 
−
 
 
−
os resume server <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova resize-revert <server>
 
−
 
 
−
os resize server --revert <server>
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova meta <server> <action> <key=value> [<key=value> ...]
 
−
 
 
−
os set server
 
−
          --meta-data <key=value>
 
−
          [--meta-data <key=value>] ...
 
−
          <server>
 
 
os unset server
 
os unset server
−
          --meta-data <key>
+
    --meta-data <key>
−
          [--meta-data <key>] ...
+
    [--meta-data <key>] ...
−
          <server>
+
    <server>
−
</nowiki></pre>
+
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova meta
 +
    <server>
 +
    <action>
 +
    <key=value>
 +
    [<key=value> ...]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server set
 +
    --root-password
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova root-password
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server show
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova show
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server ssh
 +
    [--port PORT]
 +
    --private]
 +
    [--ipv6]
 +
    [--login <login>]
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova ssh
 +
    [--port PORT]
 +
    [--private]
 +
    [--ipv6]
 +
    [--login <login>]
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server suspend
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova suspend
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server unlock
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova unlock
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server unpause
 +
    <server>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
nova unpause
 +
    <server>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os server unrescue
 +
    <server>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova unrescue
 +
    <server>
 +
</source>
 +
|}
  
 +
==== usage ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova root-password <server>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os usage list
 +
    [--start <start>]
 +
    [--end <end>]
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova usage-list
 +
    [--start <start>]
 +
    [--end <end>]
 +
</source>
 +
|}
  
−
os set server --root-password <server>
 
−
</nowiki></pre>
 
  
 +
==== volume ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
nova show <server>
+
|-
 +
! OSC Command !! Implemented !! !! Keystone command
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume attach
 +
    <volume>
 +
    <server>
 +
    <device>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova volume-attach
 +
    <server>
 +
    <volume>
 +
    <device>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume detach
 +
    <server>
 +
    <volume>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
nova volume-detach
 +
    <server>
 +
    <volume>
 +
</source>
 +
|}
  
−
os show server <server>
 
−
</nowiki></pre>
 
  
 +
==== x509-cert ====
  
−
<pre><nowiki>#!bash
+
See [[#credentials|credentials]] in the [[#Cross_API|cross API section]].
−
nova ssh [--port PORT] [--private] [--ipv6] [--login <login>] <server>
 
  
−
os ssh server
+
==== x509-root-cert ====
−
          [--port PORT]
 
−
          [--private]
 
−
          [--ipv6]
 
−
          [--login <login>]
 
−
          <server>
 
−
</nowiki></pre>
 
  
 +
See [[#credentials|credentials]] in the [[#Cross_API|cross API section]].
  
−
<pre><nowiki>#!bash
+
== Image ==
−
nova suspend <server>
 
  
−
os suspend server <server>
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Option !!  Environment Variable !!  !!  Glance Option !!  Environment Variable
 +
|-
 +
| --os-image-api-version <ver> || OS_IMAGE_API_VERSION ||  || --os-image-api-version <ver> || OS_IMAGE_API_VERSION
 +
|-
 +
|  ||  || || --os-service-type <type> || OS_SERVICE_TYPE
 +
|-
 +
|  ||  || || --os-endpoint-type <type> || OS_ENDPOINT_TYPE
 +
|-
 +
| --os-token <token> || OS_TOKEN || || --os-auth-token <token> || OS_AUTH_TOKEN
 +
|-
 +
| --os-url <url> || OS_URL || || --os-image-url <url> || OS_IMAGE_URL
 +
|-
 +
|  ||  || || --os-cacert <file> || OS_CACERT
 +
|-
 +
|  ||  || || --cert-file <file> || CERT_FILE
 +
|-
 +
|  ||  || || --key-file <key-file> || KEY_FILE
 +
|-
 +
|  ||  || || --no-ssl-compression ||
 +
|-
 +
|}
  
  
−
<pre><nowiki>#!bash
+
=== API v1 ===
−
nova unlock <server>
 
  
−
os unlock server <server>
+
==== image ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Glance command
 +
|-
 +
|
 +
<source lang="bash">
 +
os image create
 +
    [--id <id>]
 +
    [--store <store>]
 +
    [--container-format <format>]
 +
    [--disk-format <format>]
 +
    [--owner <tenant>]
 +
    [--size <size-bytes>]
 +
    [--min-disk <disk-gb>]
 +
    [--min-ram <ram-mg>]
 +
    [--location <image-url>]
 +
    [--copy-from <image-url>]
 +
    [--file <local-filename>]
 +
    [--checksum <checksum>]
 +
    [--protected | --unprotected]
 +
    [--public | --private]
 +
    [--property <key=value>]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-create
 +
    [--id <IMAGE_ID>]
 +
    [--name <NAME>]
 +
    [--disk-format <DISK_FORMAT>]
 +
    [--container-format <CONTAINER_FORMAT>]
 +
    [--owner <TENANT_ID>]
 +
    [--size <SIZE>]
 +
    [--min-disk <DISK_GB>]
 +
    [--min-ram <DISK_RAM>]
 +
    [--location <IMAGE_URL>]
 +
    [--checksum <CHECKSUM>]
 +
    [--copy-from <IMAGE_URL>]
 +
    [--is-public [True|False]]
 +
    [--is-protected [True|False]]
 +
    [--property <key=value>]
 +
    [--human-readable]
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image delete
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-delete
 +
    <IMAGE_ID>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image list
 +
    [--page-size <size>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image save
 +
    [--file <filename>]
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-download
 +
    [--file <FILE>]
 +
    <IMAGE>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image set
 +
    [--name <name>]
 +
    [--owner <tenant>]
 +
    [--min-disk <disk-gb>]
 +
    [--min-ram <ram-mg>]
 +
    [--protected | --unprotected]
 +
    [--public | --private]
 +
    [--property <key=value>]
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-update
 +
    [--name <NAME>]
 +
    [--disk-format <DISK_FORMAT>]
 +
    [--container-format <CONTAINER_FORMAT>]
 +
    [--owner <TENANT_ID>]
 +
    [--size <SIZE>]
 +
    [--min-disk <DISK_GB>]
 +
    [--min-ram <DISK_RAM>]
 +
    [--location <IMAGE_URL>]
 +
    [--file <FILE>]
 +
    [--checksum <CHECKSUM>]
 +
    [--copy-from <IMAGE_URL>]
 +
    [--is-public [True|False]]
 +
    [--is-protected [True|False]]
 +
    [--property <key=value>]
 +
    [--purge-props]
 +
    [--human-readable]
 +
    <IMAGE>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image show
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-show
 +
    [--human-readable]
 +
    <IMAGE>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
=== API v2 ===
−
nova unpause <server>
 
  
−
os unpause server <server>
+
==== image ====
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! OSC Command !! Implemented !! !! Glance command
 +
|-
 +
|
 +
<source lang="bash">
 +
os image delete
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-delete
 +
    <IMAGE_ID>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image list
 +
    [--page-size <size>]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
glance member-images
 +
    [options]
 +
    <MEMBER>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image save
 +
    [--file <filename>]
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-download
 +
    [--file <FILE>]
 +
    <IMAGE>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image set
 +
    [--id <id>]
 +
    [--store <store>]
 +
    [--container-format <format>]
 +
    [--disk-format <format>]
 +
    [--owner <tenant>]
 +
    [--size <size-bytes>]
 +
    [--min-disk <disk-gb>]
 +
    [--min-ram <ram-mg>]
 +
    [--location <image-url>]
 +
    [--copy-from <image-url>]
 +
    [--file <local-filename>]
 +
    [--checksum <checksum>]
 +
    [--protected | --unprotected]
 +
    [--public | --private]
 +
    [--property <key=value>]
 +
    <name>
 +
</source>
 +
|| no
 +
|| ||
 +
<source lang="bash">
 +
glance image-update
 +
    [--name <NAME>]
 +
    [--disk-format <DISK_FORMAT>]
 +
    [--container-format <CONTAINER_FORMAT>]
 +
    [--owner <TENANT_ID>]
 +
    [--size <SIZE>]
 +
    [--min-disk <DISK_GB>]
 +
    [--min-ram <DISK_RAM>]
 +
    [--location <IMAGE_URL>]
 +
    [--file <FILE>]
 +
    [--checksum <CHECKSUM>]
 +
    [--copy-from <IMAGE_URL>]
 +
    [--is-public [True|False]]
 +
    [--is-protected [True|False]]
 +
    [--property <key=value>]
 +
    [--purge-props]
 +
    [--human-readable]
 +
    <IMAGE>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os image show
 +
    <image>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
glance image-show
 +
    [--human-readable]
 +
    <IMAGE>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
 
−
nova unrescue <server>
 
  
−
os unrescue server <server>
+
==== image-member ====
−
</nowiki></pre>
 
  
 +
Need to discuss the future of these commands with markwash...
  
−
'''usage'''
+
<source lang="bash">
 +
glance member-create [--can-share] <IMAGE_ID> <TENANT_ID>
  
−
<pre><nowiki>#!bash
+
os create image-member ...
−
nova usage-list [--start <start>] [--end <end>]
+
</source>
  
−
os list usage ...
 
−
</nowiki></pre>
 
  
 +
<source lang="bash">
 +
glance member-delete <IMAGE_ID> <TENANT_ID>
  
−
'''volume'''
+
os list image-member <image> [options]
 +
</source>
  
−
<pre><nowiki>#!bash
 
−
nova volume-attach <server> <volume> <device>
 
  
−
os attach volume ...
+
<source lang="bash">
−
</nowiki></pre>
+
glance member-delete [options] <ID> <MEMBER>
  
 +
os delete image-member ...
 +
</source>
  
−
<pre><nowiki>#!bash
 
−
nova volume-create [--snapshot_id <snapshot_id>]
 
−
                  [--display_name <display_name>]
 
−
                  [--display_description <display_description>]
 
−
                  [--volume_type <volume_type>]
 
−
                  <size>
 
  
−
os create volume ...
+
<source lang="bash">
−
</nowiki></pre>
+
glance member-list [--image-id <IMAGE_ID>] [--tenant-id <TENANT_ID>]
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-delete <volume>
 
−
 
 
−
os delete volume ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-detach <server> <volume>
 
−
 
 
−
os detach volume ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova nova volume-list
 
−
 
 
−
os list volume
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-show <volume>
 
−
 
 
−
os show volume ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''volume-snapshot'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-snapshot-create [--force <True|False>]
 
−
                            [--display_name <display_name>]
 
−
                            [--display_description <display_description>]
 
−
                            <volume_id>
 
−
 
 
−
os create volume-snapshot ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-snapshot-delete <snapshot_id>
 
−
 
 
−
os delete volume-snapshot ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-snapshot-list
 
−
 
 
−
os list volume-snapshot
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-snapshot-show <snapshot>
 
−
 
 
−
os show volume-snapshot
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''volume-type'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-type-create <name>
 
−
 
 
−
os create volume-type ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-type-delete <id>
 
−
 
 
−
os delete volume-type ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova volume-type-list
 
−
 
 
−
os list volume-type
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''x509-cert'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova x509-create-cert [<private_key_file>] [<x509_cert>]
 
−
 
 
−
os create x509-cert ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''x509-root-cert'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
nova x509-get-root-cert [<filename>]
 
−
 
 
−
os show x509-root-cert ...
 
−
</nowiki></pre>
 
  
 +
os list image-member ...
 +
</source>
  
−
== Glance ==
+
== Volume ==
  
 +
{| class="wikitable"
 +
|-
 +
! Cinder Option !!  Environment Variable !!  !!  OSC Option !!  Environment Variable
 +
|-
 +
| --os-volume-api-version <ver> || OS_VOLUME_API_VERSION ||  || --os-volume-api-version <ver> || OS_VOLUME_API_VERSION
 +
|-
 +
| --service-type <type> ||  ||  ||  ||
 +
|-
 +
| --service-name <name> || CINDER_SERVICE_NAME ||  ||  ||
 +
|-
 +
| --volume-service-name <name> || CINDER_VOLUME_SERVICE_NAME ||  ||  ||
 +
|-
 +
| --endpoint-type <type> || CINDER_ENDPOINT_TYPE ||  ||  ||
 +
|-
 +
| --retries <int> ||  ||  ||  ||
 +
|-
 +
|}
  
−
<pre><nowiki>#!csv ,
 
−
Nova Option, Environment Variable, , OSCLI Option, Environment Variable
 
−
--force,, ,,
 
−
--dry-run,, ,,
 
−
--os-image-url <url>,OS_IMAGE_URL, ,,
 
−
--os-image-api-version <ver>,OS_IMAGE_API_VERSION, ,--os-image-api-version <ver>,OS_IMAGE_API_VERSION
 
−
--os-service-type <type>,OS_SERVICE_TYPE, ,,
 
−
--os-endpoint-type <type>,OS_ENDPOINT_TYPE, ,,
 
−
--cert-file <file>,, ,,
 
−
--key-file <file>,, ,,
 
−
--timeout <seconds>,, ,,
 
−
--no-ssl-compression,, ,,
 
−
</nowiki></pre>
 
  
 +
=== API v1.0 ===
  
−
'''image'''
+
==== limits ====
  
−
<pre><nowiki>#!bash
+
See [[#limits|limits]] in the [[#Cross_API|cross API section]].
−
glance image-create [--id <IMAGE_ID>] [--name <NAME>]
 
−
                                  [--disk-format <CONTAINER_FORMAT>]
 
−
                                  [--container-format <DISK_FORMAT>]
 
−
                                  [--owner <TENANT_ID>] [--size <SIZE>]
 
−
                                  [--min-disk <DISK_GB>] [--min-ram <DISK_RAM>]
 
−
                                  [--location <IMAGE_URL>] [--checksum <CHECKSUM>]
 
−
                                  [--copy-from <IMAGE_URL>] [--public] [--protected]
 
−
                                  [--property <key=value>]
 
  
−
os create image ...
+
==== quota ====
−
</nowiki></pre>
 
  
 +
See [[#quota|quota]] in the [[#Cross_API|cross API section]].
  
−
<pre><nowiki>#!bash
+
==== snapshot ====
−
glance image-delete <IMAGE_ID>
 
  
−
os delete image ...
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Cinder command
 +
|-
 +
|
 +
<source lang="bash">
 +
os snapshot create
 +
    --name <name>
 +
    [--description <description>]
 +
    [--force]
 +
    <volume>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder snapshot-create
 +
    --force <True|False>
 +
    --display-name <display-name>
 +
    --display-description <display-description>
 +
    <volume-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os snapshot delete
 +
    <snapshot>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder snapshot-delete
 +
    <snapshot-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os snapshot list
 +
</source>
 +
|| yes (no opts yet)
 +
|| ||
 +
<source lang="bash">
 +
cinder snapshot-list
 +
    --all-tenants [<0|1>]
 +
    --display-name <display-name>
 +
    --status <status>
 +
    --volume-id <volume-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os snapshot set
 +
    [--name <new-name>]
 +
    [--description <new-description>]
 +
    <snapshot>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder snapshot-rename
 +
    --display-description <display-description>
 +
    --display-name <display-name>
 +
    <snapshot-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os snapshot show
 +
    <snapshot>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder snapshot-show
 +
    <snapshot-id>
 +
</source>
 +
|}
  
 +
==== volume ====
  
−
<pre><nowiki>#!bash
+
{| class="wikitable"
−
glance image-list
+
|-
 +
! OSC Command !! Implemented !! !! Cinder command
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume create
 +
    --size <size>
 +
    [--description <description>]
 +
    [--volume-type <volume-type>]
 +
    [--snapshot-id <snapshot-id>]
 +
    [--source <volid>]
 +
    [--image <image-id>]
 +
    [--availability-zone <availability-zone>]
 +
    [--property <key=value>]
 +
    [--user <user>]          # admin only
 +
    [--project <project>]    # admin only
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder create
 +
    [--snapshot-id <snapshot-id>]
 +
    [--source-volid <source-volid>]
 +
    [--image-id <image-id>]
 +
    [--display-name <display-name>]
 +
    [--display-description <display-description>]
 +
    [--volume-type <volume-type>]
 +
    [--availability-zone <availability-zone>]
 +
    [--metadata <key=value>]
 +
    <size>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume delete
 +
    [--force]
 +
    <volume>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder delete
 +
    <volume-id>
  
−
os list image ...
+
cinder force-delete
−
</nowiki></pre>
+
    <volume-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume list
 +
    [--name <name>]
 +
    [--status <status>]
 +
    [--long]
 +
    [--all-tenants]          # admin only
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder list  
 +
    --all-tenants [<0|1>]
 +
    --display-name <display-name>
 +
    --status <status>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume set
 +
    [--name <new-name>]
 +
    [--description <new-description>]
 +
    [--property <key=value>]
 +
    <volume>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder metadata
 +
    <volume-id>
 +
    <action>
 +
    <key=value>
  
 +
cinder rename
 +
    --display-description <display-description>
 +
    <volume-id>
 +
    <display-name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume show
 +
    <volume>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder show
 +
    <volume-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume unset
 +
    [--property <key=value>]
 +
    <volume>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
==== volume-type ====
−
glance image-show <IMAGE_ID>
 
  
−
os show image ...
+
{| class="wikitable"
−
</nowiki></pre>
+
|-
 +
! OSC Command !! Implemented !! !! Cinder command
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume type create
 +
    [--property <key=value>]
 +
    <name>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder type-create
 +
    <type-name>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume type delete
 +
    <volume-type>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder type-delete
 +
    <type-id>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume type list
 +
    [--long]
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder type-list
  
 +
cinder extra-specs-list
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume type set
 +
    [--property <key=value>]
 +
    <volume-type>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder type-key
 +
    <type-id>
 +
    <set>
 +
    <key=value>
 +
</source>
 +
|-
 +
|
 +
<source lang="bash">
 +
os volume type unset
 +
    [--property <key>]
 +
    <volume-type>
 +
</source>
 +
|| yes
 +
|| ||
 +
<source lang="bash">
 +
cinder type-key
 +
    <type-id>
 +
    <unset>
 +
    <key>
 +
</source>
 +
|}
  
−
<pre><nowiki>#!bash
+
== Network ==
−
glance member-images [options] <MEMBER>
 
  
−
os list image --member <member> [options]
+
The Network commands in <code>quantum</code> have been in a bit of flux and are currently out of scope for OpenStackClient.
−
</nowiki></pre>
 
  
 +
{| class="wikitable"
 +
|-
 +
! Command-line Option !! Environment Variable
 +
|-
 +
| -H HOST|--host=HOST
 +
|-
 +
| -p PORT|--port=PORT
 +
|-
 +
| -s|--ssl
 +
|-
 +
| -v|--verbose
 +
|-
 +
| -f LOGFILE|--logfile=LOGFILE
 +
|-
 +
| -t TOKEN|--token=TOKEN
 +
|-
 +
| --version=VERSION || QUANTUM_VERSION
 +
|}
  
−
<pre><nowiki>#!bash
 
−
glance show [options] <ID>
 
  
−
os show image ...
+
=== API v2.0 ===
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
glance update [options] <ID> <field1=value1 field2=value2 ...>
 
−
 
 
−
os set image ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
'''image-member'''
 
−
 
 
−
<pre><nowiki>#!bash
 
−
glance member-create [--can-share] <IMAGE_ID> <TENANT_ID>
 
−
 
 
−
os create image-member ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
glance member-delete <IMAGE_ID> <TENANT_ID>
 
−
 
 
−
os list image-member <image> [options]
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
glance member-delete [options] <ID> <MEMBER>
 
−
 
 
−
os delete image-member ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
<pre><nowiki>#!bash
 
−
glance member-list [--image-id <IMAGE_ID>] [--tenant-id <TENANT_ID>]
 
−
 
 
−
os list image-member ...
 
−
</nowiki></pre>
 
−
 
 
−
 
 
−
=== Quantum ===
 
  
 
* Verbs:  
 
* Verbs:  
Line 1,684: Line 3,739:
 
** quantum: iface, net, port
 
** quantum: iface, net, port
 
** os: interface, network, port
 
** os: interface, network, port
−
 
−
'''quantum'''
 
−
 
−
<pre><nowiki>#!csv ,
 
−
Command-line Option,Environment Variable
 
−
-H HOST|--host=HOST
 
−
-p PORT|--port=PORT
 
−
-s|--ssl
 
−
-v|--verbose
 
−
-f LOGFILE|--logfile=LOGFILE
 
−
-t TOKEN|--token=TOKEN
 
−
--version=VERSION,QUANTUM_VERSION
 
−
</nowiki></pre>
 
−
 
  
 
'''iface'''
 
'''iface'''
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
plug_iface <tenant-id> <net-id> <port-id> <iface-id>
 
plug_iface <tenant-id> <net-id> <port-id> <iface-id>
  
 
add interface <tenant> <network> <port> <interface>
 
add interface <tenant> <network> <port> <interface>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
show_iface <tenant-id> <net-id> <port-id>
 
show_iface <tenant-id> <net-id> <port-id>
  
 
show interface <tenant> <network> <port>
 
show interface <tenant> <network> <port>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
unplug_iface <tenant-id> <net-id> <port-id>
 
unplug_iface <tenant-id> <net-id> <port-id>
  
 
remove interface <tenant> <network> <port>
 
remove interface <tenant> <network> <port>
−
</nowiki></pre>
+
</source>
  
  
 
'''net'''
 
'''net'''
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
create_net <tenant-id> <net-name>
 
create_net <tenant-id> <net-name>
  
 
create network <tenant> <network-name>
 
create network <tenant> <network-name>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
delete_net <tenant-id> <net-id>
 
delete_net <tenant-id> <net-id>
  
 
delete <tenant> <network>
 
delete <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
list_nets <tenant-id>
 
list_nets <tenant-id>
  
 
list network <tenant>
 
list network <tenant>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
list_nets_detail <tenant-id>
 
list_nets_detail <tenant-id>
  
 
list network --detail <tenant>
 
list network --detail <tenant>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
show_net <tenant-id> <net-id>
 
show_net <tenant-id> <net-id>
  
 
show network <tenant> <network>
 
show network <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
show_net_detail <tenant-id> <net-id>
 
show_net_detail <tenant-id> <net-id>
  
 
show network --detail <tenant> <network>
 
show network --detail <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
update_net <tenant-id> <net-id> <new-name>
 
update_net <tenant-id> <net-id> <new-name>
  
 
set network <tenant> <network> --name <name>
 
set network <tenant> <network> --name <name>
−
</nowiki></pre>
+
</source>
  
  
 
'''port'''
 
'''port'''
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
create_port <tenant-id> <net-id>
 
create_port <tenant-id> <net-id>
  
 
create port <tenant> <network>
 
create port <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
delete_port <tenant-id> <net-id> <port-id>
 
delete_port <tenant-id> <net-id> <port-id>
  
 
delete port <tenant> <network> <port>
 
delete port <tenant> <network> <port>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
list_ports <tenant-id> <net-id>
 
list_ports <tenant-id> <net-id>
  
 
list port <tenant> <network>
 
list port <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
list_ports_detail <tenant-id> <net-id>
 
list_ports_detail <tenant-id> <net-id>
  
 
list port --detail <tenant> <network>
 
list port --detail <tenant> <network>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
show_port <tenant-id> <net-id> <port-id>
 
show_port <tenant-id> <net-id> <port-id>
  
 
show port <tenant> <network> <port>
 
show port <tenant> <network> <port>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
show_port_detail <tenant-id> <net-id> <port-id>
 
show_port_detail <tenant-id> <net-id> <port-id>
  
 
show port --detail <tenant> <network> <port>
 
show port --detail <tenant> <network> <port>
−
</nowiki></pre>
+
</source>
  
  
−
<pre><nowiki>#!bash
+
<source lang="bash">
 
update_port <tenant-id> <net-id> <port-id> <params>
 
update_port <tenant-id> <net-id> <port-id> <params>
  
 
set port <tenant> <network> <port> <params>
 
set port <tenant> <network> <port> <params>
−
</nowiki></pre>
+
</source>
−
 
 
  
−
== Options ==
+
= Options =
  
 
In general, options will be transformed into more UNIX-like usage
 
In general, options will be transformed into more UNIX-like usage

Latest revision as of 02:10, 19 July 2013

Redirect to:

Note: this page is being deprecated in favor of a new OpenStackClient Commands page with the correct name.

OpenStackClient Commands

Part of the UnifiedCLI proposal

[Note that the use of the word object here is its generic meaning as the target of an action.]

Command Structure

The OpenStackClient has a consistent and predictable format for all of its commands.

  • The top level command name is openstack
  • Sub-commands take the form:
openstack [<global-options>] <object> <verb> [<second-object>] [<command-local-arguments>]

Note: The command format change was committed on 13May2013. This is the new format.


Command Arguments

  • All long options names shall use '-' as the interpolation character (--like-this)
  • Authentication options conform to a revised version of the original CLIAuth
  • Global arguments generally 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 can be derived from the option by dropping the leading '--', converting all embedded dashes ('-') to underscores ('_'), and converting to upper case.
  • Positional arguments trail command options.
  • Some commands require two objects be acted upon, both objects appear in the command and if both are positional arguments they appear in the same order as in the command. In words it can be expressed as "(given) object1 add object2 (to it)"
 * <object-1> <verb> <object-2>
   * group add user
   * access token list   (here, 'access token' is a two-word single object)
   * user list role (needs more thinking)

Other

  • Arguments that normally require an ID in the OS-API may also use the name or other short identifier where reasonable to support
  • Optional machine-parsable format is available with list and show commands. List has an option for CSV-formatted output (see --format, --quote options for a list command) while show has an option for shell-assignment formatted output (see --format option for a show command).

Verbs

The verbs used by the default OpenStack clients are defined below to provide a consistent meaning to each action. Many of them have logical opposite actions. Those verbs with an opposite action are noted in parens if applicable.

  • authorize - authorize a token (used in OAuth)
  • add (remove) - add some object to a container object; the command is built in the order of "container add object" (<container> <object>), the positional arguments appear in the same order
  • attach (detach) - connect two objects (is this different from add/remove? not really, use the same argument order as add)
  • create (delete) - create a new occurrance of the specified object
  • delete (create) - delete a specific occurrance of the specified object
  • detach (attach) - disconnect two objects (is this different from add/remove?)
  • list - display summary information about multiple objects
  • lock (unlock)
  • migrate - move a server to a different host; --live performs a live migration if possible
  • pause (unpause) - stop a server and leave it in memory
  • reboot - forcibly reboot a server
  • rebuild - rebuild a server using (most of) the same arguments as in the original create
  • remove (add) - remove an object from a group of objects
  • rescue (unrescue) - reboot a server in a special rescue mode allowing access to the original disks
  • resize - change a server's flavor
  • resume (suspend) - return a suspended server to running state
  • save - download an object locally
  • set (unset) - set an attribute of the object, often called metadata
  • show - display detailed information about the specifiec object
  • ssh
  • suspend (resume) - stop a server and save to disk freeing memory
  • unlock (lock)
  • unpause (pause) - return a paused server to running state
  • unrescue (rescue) - return a server to normal boot mode
  • unset (set) - remove an attribute of the object


Objects

Note: these need a review to sync up with the revised object names without dashes ('-') in them.


Global Options

The common global options from the default OpenStack clients have been mapped to the set of global options below.

OSC Option Environment Variable Option Environment Variable
--version --version
--help --help
--debug --debug
--quiet
--verbose
--log-file <filename>
--os-auth-url <url> OS_AUTH_URL --os-auth-url <url> OS_AUTH_URL
--os-tenant-name <name> OS_TENANT_NAME --os-tenant-name <name> OS_TENANT_NAME
--os-tenant-id <id> OS_TENANT_ID --os-tenant-id <id> OS_TENANT_ID
--os-username <name> OS_USERNAME --os-username <name> OS_USERNAME
--os-password <pw> OS_PASSWORD --os-password <pw> OS_PASSWORD
--os-region-name <region> OS_REGION_NAME --os-region-name <region> OS_REGION_NAME
--os-cacert <file> OS_CACERT --os-cacert <file> OS_CACERT
--insecure
--os-use-keyring


Common Options

A number of options will appear in many commands and should have the same form in all commands to the extent possible.

Option Description Usual Default
--description describes an object none
--enable Used for setting the enabled state for an object n/a
--disable Used for setting the enabled state for an object n/a


Command Mapping Summary

This is an example mapping of the existing commands from Keystone (Identity), Nova (Compute), Glance (Image) and Cinder (Volume) to the <verb> <object> form for the OpenStackClient cli tool. It reduces both the number of verbs and objects by handling some of the smaller differences with command line options.

Further consolidation could be achieved by additional options or by introduction secondary objects to the syntax. For example, the credentials and x509-cert (and x509-root-cert) objects could be combined:


nova x509-create-cert [<pk-file>] [<x509-cert>] os create credentials --x509 [<pk-file>] [<x509-cert>]
nova credentials os show credentials
nova x509-get-root-cert os show credentials --x509 --root


Cross API

Object names that appear in multiple APIs, like quota, are handled by putting their command handler classes in openstackclient.common. If the number of these becomes large they should be moved into a subdirectory.

credentials

[consider rolling the ec2 creds into this too]

OSC Command Implemented Keystone command 
os credentials create
    --x509
    [<private-key-file>]
    [<certificate-file>]
no 
nova x509-create-cert
    [<pk-file>]
    [<x509-cert>]

os credentials show
    [--token]
    [--user]
    [--x509 [--root]]
no 
nova credentials
    [--wrap <integer>]

nova x509-get-root-cert
    [<filename>]

limits

OSC Command Implemented Keystone command 
os limits show
    --absolute [--reserved] | --rate
yes 
nova absolute-limits
    [--reserved]

nova rate-limits

cinder absolute-limits

cinder rate-limits

quota

OSC Command Implemented Keystone command 
os quota set
    # Compute settings
    [--cores <num-cores>]
    [--fixed-ips <num-fixed-ips>]
    [--floating-ips <num-floating-ips>]
    [--injected-file-size <injected-file-bytes>]
    [--injected-files <num-injected-files>]
    [--instances <num-instances>] 
    [--key-pairs <num-key-pairs>]
    [--properties <num-properties>]
    [--ram <ram-mb>] 

    # Volume settings
    [--gigabytes <new-gigabytes>]
    [--snapshots <new-snapshots>]
    [--volumes <new-volumes>]

    <project>
yes 
nova quota-update
    [--instances <instances>] 
    [--cores <cores>]
    [--ram <ram>] 
    [--volumes <volumes>]
    [--gigabytes <gigabytes>]
    [--floating-ips <floating_ips>]
    [--metadata-items <metadata_items>]
    [--injected-files <injected_files>]
    [--injected-file-content-bytes <injected_file_content_bytes>]
    <tenant_id>

cinder quota-update
    [--volumes <volumes>]
    [--snapshots <snapshots>]
    [--gigabytes <gigabytes>]
    <tenant_id>

os quota set
    --class
    # Compute settings
    [--cores <num-cores>]
    [--fixed-ips <num-fixed-ips>]
    [--floating-ips <num-floating-ips>]
    [--injected-file-size <injected-file-bytes>]
    [--injected-files <num-injected-files>]
    [--instances <num-instances>] 
    [--key-pairs <num-key-pairs>]
    [--properties <num-properties>]
    [--ram <ram-mb>] 

    # Volume settings
    [--gigabytes <new-gigabytes>]
    [--snapshots <new-snapshots>]
    [--volumes <new-volumes>]

    <class>
yes 
nova quota-class-update 
    [--instances <instances>] 
    [--cores <cores>]
    [--ram <ram>] 
    [--volumes <volumes>]
    [--gigabytes <gigabytes>]
    [--floating-ips <floating_ips>]
    [--metadata-items <metadata_items>]
    [--injected-files <injected_files>]
    [--injected-file-content-bytes <injected_file_content_bytes>]
    <class>

cinder quota-class-update
    [--volumes <volumes>]
    [--snapshots <snapshots>]
    [--gigabytes <gigabytes>]
    <tenant_id>

os quota show
    [--default]
    <project>
yes 
nova quota-show
    [--tenant <tenant-id>]

cinder quota-show
    <tenant_id>

nova quota-defaults
    <tenant_id>

cinder quota-defaults
    <tenant_id>

os quota show
    --class
    <class>
yes 
nova quota-class-show
    <class>

cinder quota-class-show
    <class>

Identity

OSC Option Environment Variable Keystone Option Environment Variable
--os-identity-api-version <ver> OS_IDENTITY_API_VERSION --os-identity-api-version <ver> OS_IDENTITY_API_VERSION
--os-token <token> OS_TOKEN --os-token <token> OS_SERVICE_TOKEN
--os-url <url> OS_URL --os-endpoint <url> OS_SERVICE_ENDPOINT
--os-cert <file> OS_CERT
--os-key <key-file> OS_KEY
--os-cache OS_CACHE
--force-new-token
--stale-duration <seconds>

API v2.0

catalog

OSC Command Implemented Keystone command 
os catalog show
    [--service <service>]
no 
keystone catalog
    [--service <service-type>]

ec2 credentials

OSC Command Implemented Keystone command 
os ec2 credentials create
    [--project <project>]
    [--user <user>]
yes 
keystone ec2-credentials-create
    [--user <user-id>] 
    [--tenant_id <tenant-id>]

os ec2 credentials delete
    [--user <user>]
    <access-key>
yes 
keystone ec2-credentials-delete
    [--user <user-id>] 
    --access <access-key>

os ec2 credentials list
    [--user <user>]
yes 
keystone ec2-credentials-list
    [--user <user-id>]

os ec2 credentials show
    [--user <user>]
    <access-key>
yes 
keystone ec2-credentials-get
    [--user <user-id>] 
    --access <access-key>

endpoint

OSC Command Implemented Keystone command 
os endpoint create
    --publicurl <public-url>
    [--adminurl <admin-url>]
    [--internalurl <internal-url>]
    [--region <endpoint-region>]
    <service>
yes 
keystone endpoint-create
    [--region <endpoint-region>]
    [--service_id <service-id>]
    [--publicurl <public-url>]
    [--adminurl <admin-url>]
    [--internalurl <internal-url>]

os endpoint delete
    <endpoint-id>
yes 
keystone endpoint-delete
    <endpoint-id>

os endpoint list
    [--long]
yes 
keystone endpoint-list

os endpoint show
    [--type <endpoint-type>]
    [--attr <endpoint-attribute>] 
    [--value <endpoint-value>]
    [--all]
    <service-type>
yes 
keystone endpoint-get
    --service <service-type>
    [--endpoint_type <endpoint-type>]
    [--attr <service-attribute>] 
    [--value <value>]

role

OSC Command Implemented Keystone command 
os role create
    <role-name>
yes 
keystone role-create --name
    <role-name>

os role delete
    <role>
yes 
keystone role-delete
    <role-id>

os role list
yes 
keystone role-list

os role show
    <role>
yes 
keystone role-get
    <role-id>

service

OSC Command Implemented Keystone command 
os service create
    [--type <service-type>]
    [--description <service-description>]
    <service-name>
yes 
keystone service-create
    --name <name> 
    --type <type>
    [--description <service-description>]

os service delete
    <service>
yes 
keystone service-delete
    <service-id>

os service list
    [--long]
yes 
keystone service-list

os service show
    [--catalog]
    <service>
yes 
keystone service-get
    <service-id>

tenant

OSC Command Implemented Keystone command 
os tenant create
    [--description <description>]
    [--enable | --disable]
    <tenant-name>
yes 
keystone tenant-create
    --name <tenant-name>
    [--description <tenant-description>]
    [--enabled <true|false>]

os tenant delete
    <tenant>
yes 
keystone tenant-delete
    <tenant>

os tenant list
    [--long]
yes 
keystone tenant-list

os tenant set
    [--name <new-tenant-name>]
    [--description <new-tenant-description>]
    [--enable | --disable]
    <tenant>
yes 
keystone tenant-update
    [--name <tenant_name>]
    [--description <tenant-description>]
    [--enabled <true|false>]
    <tenant-id>

os tenant show
    <tenant>
yes 
keystone tenant-get
    <tenant-id>

token

OSC Command Implemented Keystone command 
os token show
    [--width <token-display-width>]
 ?? 
keystone token-get [--wrap <integer>]

user

OSC Command Implemented Keystone command 
os user create
    [--password <user-password>]
    [--email <user-email>]
    [--tenant <tenant>]
    [--enable | --disable]
    <user-name>
yes 
keystone user-create
    --name <user-name> 
    [--tenant_id <tenant-id>]
    [--pass <pass>] 
    [--email <email>]
    [--enabled <true|false>]

os user delete
    <user>
yes 
keystone user-delete
    <user-id>

os user list
    [--tenant <tenant>]
    [--long]
yes 
keystone user-list
    [<tenant-id>]

os user set
    [--name <new-user-name>]
    [--password <user-password>]
    [--email <user-email>]
    [--tenant <tenant>]
    [--enable|--disable]
    <user>
yes 
keystone user-password-update
    --pass <password>
    <user-id>

os user show
    <user>
yes 
keystone user-get
    <user-id>

user role

OSC Command Implemented Keystone command 
os user role add
    [--tenant <tenant>]
    <user>
    <role>
yes 
keystone user-role-add
    --user <user-id>
    --role <role-id>
    [--tenant_id <tenant-id>]

os user role list
    [--tenant <tenant>]
    [<user>]
yes 
keystone user-role-list
    [--user <user-id>]
    [--tenant_id <tenant-id>]

os user role remove
    [--tenant <tenant>]
    <user>
    <role>
yes 
keystone user-role-remove
    --user <user-id>
    --role <role-id>
    [--tenant_id <tenant-id>]

<other>

These keystone commands are not planned for re-implementation in OpenStackClient 

keystone bootstrap
        --pass <password>
        [--user-name <user-name>]
        [--role-name <role-name>]
        [--tenant-name <tenant-name>]

keystone discover

API v3

credential

OSC Command Implemented Keystone command 
os credential create
    [--project <project>]
    [--type ec2|cert]
    <user>
    <data>
yes 
keystone credential-create
    --user_id <user-id>
    --type <credential-type>
    --data <credential-data>
    [--project_id <project-id>]

os credential delete
    <credential-id>
yes 
keystone credential-delete
    <credential-id>

os credential list
yes 
keystone credential-list

os credential set
    [--user <user>]
    [--type ec2|cert]
    [--data <data>]
    [--project <project>]
    <credential-id>
yes 
keystone credential-update
    [--user <user>]
    [--type <type>]
    [--data <data>]
    [--project <project>]
    <credential-id>

os credential show
    <credential-id>
yes 
keystone credential-get
    <credential-id>

domain

OSC Command Implemented Keystone command 
os domain create
    [--description <domain-description>]
    [--enable | --disable]
    <domain-name>
yes 
keystone domain-create
    --name <domain-name>
    [--description <domain-description>]
    [--enabled <true|false>]
    [--private_project_names <true|false>]
    [--private_user_names <true|false>]

os domain delete
    <domain>
yes 
keystone domain-delete
    <domain-id>

os domain list
yes 
keystone domain-list

os domain set
    [--name <new-domain-name>]
    [--description <new-domain-description>]
    [--enable | --disable]
    <domain>
yes 
keystone domain-update
    [--name <domain_name>]
    [--description <domain-description>]
    [--enabled <true|false>]
    [--private_project_names <true|false>]
    [--private_user_names <true|false>]
    <domain-id>

os domain show
    <domain>
yes 
keystone domain-get
    <domain-id>

endpoint

OSC Command Implemented Keystone command 
os endpoint create
    [--region <endpoint-region>
    [--enable | --disable]
    <service>
    <interface admin|public|internal>
    <url>
yes 
keystone endpoint-create 
    [--region <endpoint-region>
    [--enable | --disable]
    <service_id>
    <interface admin|public|internal>
    <url>

os endpoint delete
    <endpoint-id>
yes 







os endpoint list
    [--long]



 yes

 


keystone endpoint-list








os endpoint set
    [--interface <endpoint-interface>]
    [--url <endpoint-url>]
    [--service <service-id>]
    [--region <endpoint-region>]
    [--enable | --disable]
    <endpoint>



 yes

 


keystone endpoint-set
    [--interface <endpoint-interface>]
    [--url <endpoint-url>]
    [--service <service-id>]
    [--region <endpoint-region>]
    [--enable | --disable]
    <endpoint>








os endpoint show
    <endpoint>



 yes

 


keystone endpoint-get 
    <endpoint>





group






 OSC Command 
 Implemented 
 
 Keystone command






os group create
    [--domain <domain>]
    [--description <group-description>]
    <group-name>



 yes

 


keystone group-create
    --name <group-name>
    [--domain_id <domain-id>]
    [--description <group-description>]








os group delete
    <group>



 yes

 


keystone group-delete
    <group-id>








os group list
    [--long]



 yes

 


keystone group-list








os group set
    [--name <new-group-name>]
    [--domain <domain>]
    [--description <new-group-description>]
    <group>



 yes

 


keystone group-update
    [--name <group_name>]
    [--domain_id <domain-id>]
    [--description <group-description>]
    <group-id>








os group show
    <group>



 yes

 


keystone group-get
    <group-id>





oauth






 OSC Command 
 Implemented 
 
 Keystone command






os access token create
    --consumer-key <consumer-key>
    --consumer-secret <consumer-secret>
    --request-key <request-key>
    --request-secret <request-secret>
    --verifier <pin>



 yes

 


n/a






 look at some alternatives: 
 
 







os oauth token create
    --consumer-key <consumer-key>
    --consumer-secret <consumer-secret>
    --request-key <request-key>
    --request-secret <request-secret>
    --verifier <pin>



 nyet

 


* makes the token specific to oauth
* add [--oauth-ver X] if versioning for oauth2 is an issue?








os oauth token create
    --access
    --consumer-key <consumer-key>
    --consumer-secret <consumer-secret>
    --request-key <request-key>
    --request-secret <request-secret>
    --verifier <pin>

os oauth token create
    --request
    --consumer-key <consumer-key>
    --roles <roles>



 nyet

 


* collapse 'access token' and 'request token' into 'oauth token'?





policy






 OSC Command 
 Implemented 
 
 Keystone command






os policy create
    [--type <policy-type>]
    --blob-file <blob-file>



 yes

 


keystone policy-create
    --type <policy-type>
    --blob <policy-blob>








os policy delete
    <policy-id>



 yes

 


keystone policy-delete
    <policy-id>








os policy list
    [--include-blob]



 yes

 


keystone policy-list








os policy set
    [--type <policy-type>]
    [--blob-file<blob-file>]
    <policy-id>



 yes

 


keystone policy-update
    [--type <policy-type>]
    [--blob <policy-blob>]
    <policy-id>








os policy show
    <policy-id>



 yes

 


keystone policy-get
    <policy-id>





project






 OSC Command 
 Implemented 
 
 Keystone command






os project create
    [--domain <project-domain>]
    [--description <project-description>]
    [--enable | --disable]
    <project-name>



 yes

 


keystone project-create
    [--domain_id <domain_id>]
    [--description <description>]
    [--enable | --disable]
    <name>








os project delete
    <project>



 yes

 


os project-delete
    <project_id>








os project list
    [--long]



 yes

 


keystone project-list








os project set
    [--name <new-project-name>]
    [--domain <project-domain>]
    [--description <new-project-description>]
    [--enable | --disable]
    <project>



 yes

 


keystone project-set
    [--name <new-project-name>]
    [--domain <project-domain>]
    [--description <new-project-description>]
    [--enable | --disable]
    <project_id>








os project show
    <project>



 yes

 


keystone project-get
    <project_id>





role






 OSC Command 
 Implemented 
 
 Keystone command






os role add
    [--user <user> | --group <group>]
    [--domain <domain> | --project <project>]
    <role>



 yes

 









os role create
    <role-name>



 yes

 









os role delete
    <role>



 yes

 









os role list



 yes

 









os role remove
    [--user <user> | --group <group>]
    [--domain <domain> | --project <project>]
    <role>



 yes

 









os role set
    [--name <new-role-name>]
    <role>



 yes

 









os role show
    <role>



 yes

 






service






 OSC Command 
 Implemented 
 
 Keystone command






os service create
	[--name <name>]
        [--enabled <true|false>]
        <type>



 yes

 


keystone service-create
	[--name <name>]
        [--enabled <true|false>]
        <type>








os service delete
    <service>



 yes

 


keystone service-delete
    <service_id>








os list service



 yes

 


keystone service-list








os service set
    [--type <service-type>]
    [--name <new-name>]
    [--enable | --disable]
    <service>



 yes

 


keystone service-set
    [--type <service-type>]
    [--name <new-name>]
    [--enable | --disable]
    <service>








os service show
    <service>



 yes

 


keystone service-get 
    <service_id>





user






 OSC Command 
 Implemented 
 
 Keystone command






os user create
    [--password <password>] 
    [--project <project>]
    [--email <user-email>]
    [--enable | --disable]
    <name>



 yes

 


keystone user-create
    --name <user-name> 
    [--domain_id <domain-id>]
    [--default_project_id <project-id>]
    [--description <description>]
    [--enabled <true|false>]
    [--password <password>]








os user delete
    <user>



 yes

 


keystone user-delete
    <user-id>








os user list
    [--project <project>]
    [--long]



 yes

 


keystone user-list








os user set
    [--name <new-name>]
    [--password <password>] 
    [--project <project>]
    [--email <user-email>]
    [--enable | --disable]
    <user>



 yes

 


keystone user-update
    --user_id <user-id>
    [--name <user-name>]
    [--domain_id <domain-id>]
    [--default_project_id <project-id>]
    [--description <description>]