openstack/openstack-manuals
Code Issues Proposed changes

New heading style (plus)

Browse Source 
A recent change in openstack-doc-tools caused the heading style
to change. This changeset updates the clients where that
change is present and where small additional other changes exist
(such as minor changes in formatting options, etc.) namely:

    barbican
    designate
    glance
    heat
    mistral
    senlin

This is done to ensure consistency as recent client updates
have already switched to this mode.

Change-Id: I45d40eb7a07b38ce3c0241094c27195f253a4893
This commit is contained in:
Peter Stachowski 2016-03-15 22:21:30 +00:00
parent 489d25544e
commit 9c00546da8
6 changed files with 538 additions and 945 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

146
doc/cli-reference/source/barbican.rst
View File

@ -167,14 +167,12 @@ barbican acl delete
Delete ACLs for a secret or container as identified by its href. Delete ACLs for a secret or container as identified by its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret or container. The URI reference for the secret or container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -186,21 +184,19 @@ barbican acl get
.. code-block:: console .. code-block:: console
usage: barbican acl get [-h] [-f {csv,html,json,table,value,yaml}] [-c COLUMN] usage: barbican acl get [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
URI URI
Retrieve ACLs for a secret or container by providing its href. Retrieve ACLs for a secret or container by providing its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret or container. The URI reference for the secret or container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -212,8 +208,8 @@ barbican acl submit
.. code-block:: console .. code-block:: console
usage: barbican acl submit [-h] [-f {csv,html,json,table,value,yaml}] usage: barbican acl submit [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-c COLUMN] [--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
[--user [USERS]] [--user [USERS]]
[--project-access | --no-project-access] [--project-access | --no-project-access]
@ -222,14 +218,12 @@ barbican acl submit
Submit ACL on a secret or container as identified by its href. Submit ACL on a secret or container as identified by its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret or container. The URI reference for the secret or container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -253,8 +247,8 @@ barbican acl user add
.. code-block:: console .. code-block:: console
usage: barbican acl user add [-h] [-f {csv,html,json,table,value,yaml}] usage: barbican acl user add [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-c COLUMN] [--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
[--user [USERS]] [--user [USERS]]
[--project-access | --no-project-access] [--project-access | --no-project-access]
@ -263,14 +257,12 @@ barbican acl user add
Add ACL users to a secret or container as identified by its href. Add ACL users to a secret or container as identified by its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret or container. The URI reference for the secret or container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -294,7 +286,7 @@ barbican acl user remove
.. code-block:: console .. code-block:: console
usage: barbican acl user remove [-h] [-f {csv,html,json,table,value,yaml}] usage: barbican acl user remove [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
@ -305,14 +297,12 @@ barbican acl user remove
Remove ACL users from a secret or container as identified by its href. Remove ACL users from a secret or container as identified by its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret or container. The URI reference for the secret or container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -336,21 +326,18 @@ barbican ca get
.. code-block:: console .. code-block:: console
usage: barbican ca get [-h] [-f {html,json,shell,table,value,yaml}] usage: barbican ca get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[-c COLUMN] [--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent] [--prefix PREFIX]
[--prefix PREFIX]
URI URI
Retrieve a CA by providing its URI. Retrieve a CA by providing its URI.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the CA. The URI reference for the CA.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -362,15 +349,14 @@ barbican ca list
.. code-block:: console .. code-block:: console
usage: barbican ca list [-h] [-f {csv,html,json,table,value,yaml}] [-c COLUMN] usage: barbican ca list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
[--limit LIMIT] [--offset OFFSET] [--name NAME] [--limit LIMIT] [--offset OFFSET] [--name NAME]
List cas. List cas.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -393,7 +379,7 @@ barbican secret container create
.. code-block:: console .. code-block:: console
usage: barbican secret container create [-h] usage: barbican secret container create [-h]
[-f {html,json,shell,table,value,yaml}] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
[--name NAME] [--type TYPE] [--name NAME] [--type TYPE]
@ -401,8 +387,7 @@ barbican secret container create
Store a container in Barbican. Store a container in Barbican.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -429,14 +414,12 @@ barbican secret container delete
Delete a container by providing its href. Delete a container by providing its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the container The URI reference for the container
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -448,22 +431,19 @@ barbican secret container get
.. code-block:: console .. code-block:: console
usage: barbican secret container get [-h] usage: barbican secret container get [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
URI URI
Retrieve a container by providing its URI. Retrieve a container by providing its URI.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the container. The URI reference for the container.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -475,8 +455,7 @@ barbican secret container list
.. code-block:: console .. code-block:: console
usage: barbican secret container list [-h] usage: barbican secret container list [-h] [-f {csv,json,table,value,yaml}]
[-f {csv,html,json,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
@ -485,8 +464,7 @@ barbican secret container list
List containers. List containers.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -515,14 +493,12 @@ barbican secret delete
Delete a secret by providing its URI. Delete a secret by providing its URI.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret The URI reference for the secret
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -534,22 +510,20 @@ barbican secret get
.. code-block:: console .. code-block:: console
usage: barbican secret get [-h] [-f {html,json,shell,table,value,yaml}] usage: barbican secret get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[-c COLUMN] [--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--decrypt] [--payload] [--prefix PREFIX] [--decrypt] [--payload]
[--payload_content_type PAYLOAD_CONTENT_TYPE] [--payload_content_type PAYLOAD_CONTENT_TYPE]
URI URI
Retrieve a secret by providing its URI. Retrieve a secret by providing its URI.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret. The URI reference for the secret.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -577,8 +551,8 @@ barbican secret list
.. code-block:: console .. code-block:: console
usage: barbican secret list [-h] [-f {csv,html,json,table,value,yaml}] usage: barbican secret list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-c COLUMN] [--max-width <integer>] [--noindent] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
[--limit LIMIT] [--offset OFFSET] [--name NAME] [--limit LIMIT] [--offset OFFSET] [--name NAME]
[--algorithm ALGORITHM] [--bit-length BIT_LENGTH] [--algorithm ALGORITHM] [--bit-length BIT_LENGTH]
@ -586,8 +560,7 @@ barbican secret list
List secrets. List secrets.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -619,8 +592,7 @@ barbican secret order create
.. code-block:: console .. code-block:: console
usage: barbican secret order create [-h] usage: barbican secret order create [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
[--name NAME] [--algorithm ALGORITHM] [--name NAME] [--algorithm ALGORITHM]
@ -636,14 +608,12 @@ barbican secret order create
Create a new order. Create a new order.
Positional arguments **Positional arguments:**
--------------------
``type`` ``type``
the type of the order to create. the type of the order to create.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -701,14 +671,12 @@ barbican secret order delete
Delete an order by providing its href. Delete an order by providing its href.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the order The URI reference for the order
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -720,21 +688,19 @@ barbican secret order get
.. code-block:: console .. code-block:: console
usage: barbican secret order get [-h] [-f {html,json,shell,table,value,yaml}] usage: barbican secret order get [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
URI URI
Retrieve an order by providing its URI. Retrieve an order by providing its URI.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference order. The URI reference order.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -746,7 +712,7 @@ barbican secret order list
.. code-block:: console .. code-block:: console
usage: barbican secret order list [-h] [-f {csv,html,json,table,value,yaml}] usage: barbican secret order list [-h] [-f {csv,json,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
@ -754,8 +720,7 @@ barbican secret order list
List orders. List orders.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -774,7 +739,7 @@ barbican secret store
.. code-block:: console .. code-block:: console
usage: barbican secret store [-h] [-f {html,json,shell,table,value,yaml}] usage: barbican secret store [-h] [-f {json,shell,table,value,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--name NAME] [--prefix PREFIX] [--name NAME]
[--payload PAYLOAD] [--secret-type SECRET_TYPE] [--payload PAYLOAD] [--secret-type SECRET_TYPE]
@ -785,8 +750,7 @@ barbican secret store
Store a secret in Barbican. Store a secret in Barbican.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -837,8 +801,7 @@ barbican secret update
Update a secret with no payload in Barbican. Update a secret with no payload in Barbican.
Positional arguments **Positional arguments:**
--------------------
``URI`` ``URI``
The URI reference for the secret. The URI reference for the secret.
@ -846,8 +809,7 @@ Positional arguments
``payload`` ``payload``
the unencrypted secret the unencrypted secret
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit

252
doc/cli-reference/source/designate.rst
View File

@ -24,7 +24,7 @@ designate usage
.. code-block:: console .. code-block:: console
usage: designate [--version] [-v] [--log-file LOG_FILE] [-q] [-h] [--debug] usage: designate [--version] [-v | -q] [--log-file LOG_FILE] [-h] [--debug]
[--os-username OS_USERNAME] [--os-user-id OS_USER_ID] [--os-username OS_USERNAME] [--os-user-id OS_USER_ID]
[--os-user-domain-id OS_USER_DOMAIN_ID] [--os-user-domain-id OS_USER_DOMAIN_ID]
[--os-user-domain-name OS_USER_DOMAIN_NAME] [--os-user-domain-name OS_USER_DOMAIN_NAME]
@ -52,12 +52,12 @@ designate optional arguments
``-v, --verbose`` ``-v, --verbose``
Increase verbosity of output. Can be repeated. Increase verbosity of output. Can be repeated.
``--log-file LOG_FILE``
Specify a file to log output. Disabled by default.
``-q, --quiet`` ``-q, --quiet``
Suppress output except warnings and errors. Suppress output except warnings and errors.
``--log-file LOG_FILE``
Specify a file to log output. Disabled by default.
``-h, --help`` ``-h, --help``
Show this help message and exit. Show this help message and exit.
@ -155,16 +155,14 @@ designate diagnostics-ping
.. code-block:: console .. code-block:: console
usage: designate diagnostics-ping [-h] usage: designate diagnostics-ping [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] --service [--noindent] [--prefix PREFIX] --service
SERVICE --host HOST SERVICE --host HOST
Ping a service on a given host Ping a service on a given host
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -182,8 +180,7 @@ designate domain-create
.. code-block:: console .. code-block:: console
usage: designate domain-create [-h] usage: designate domain-create [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] --name NAME [--noindent] [--prefix PREFIX] --name NAME
--email EMAIL [--ttl TTL] --email EMAIL [--ttl TTL]
@ -191,8 +188,7 @@ designate domain-create
Create Domain Create Domain
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -216,22 +212,19 @@ designate domain-delete
.. code-block:: console .. code-block:: console
usage: designate domain-delete [-h] usage: designate domain-delete [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
id id
Delete Domain Delete Domain
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -243,22 +236,19 @@ designate domain-get
.. code-block:: console .. code-block:: console
usage: designate domain-get [-h] usage: designate domain-get [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
id id
Get Domain Get Domain
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -270,15 +260,13 @@ designate domain-list
.. code-block:: console .. code-block:: console
usage: designate domain-list [-h] usage: designate domain-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-f {csv,html,json,json,table,value,yaml,yaml}] [--max-width <integer>] [--noindent]
[-c COLUMN] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
List Domains List Domains
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -290,8 +278,7 @@ designate domain-servers-list
.. code-block:: console .. code-block:: console
usage: designate domain-servers-list [-h] usage: designate domain-servers-list [-h] [-f {csv,json,table,value,yaml}]
[-f {csv,html,json,json,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
@ -299,14 +286,12 @@ designate domain-servers-list
List Domain Servers List Domain Servers
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -318,8 +303,7 @@ designate domain-update
.. code-block:: console .. code-block:: console
usage: designate domain-update [-h] usage: designate domain-update [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--name NAME] [--noindent] [--prefix PREFIX] [--name NAME]
[--email EMAIL] [--ttl TTL] [--email EMAIL] [--ttl TTL]
@ -328,14 +312,12 @@ designate domain-update
Update Domain Update Domain
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -361,22 +343,19 @@ designate quota-get
.. code-block:: console .. code-block:: console
usage: designate quota-get [-h] usage: designate quota-get [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[-f {html,json,json,shell,table,value,yaml,yaml}] [--max-width <integer>] [--noindent]
[-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
tenant_id tenant_id
Get Quota Get Quota
Positional arguments **Positional arguments:**
--------------------
``tenant_id`` ``tenant_id``
Tenant ID Tenant ID
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -388,22 +367,19 @@ designate quota-reset
.. code-block:: console .. code-block:: console
usage: designate quota-reset [-h] usage: designate quota-reset [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
tenant_id tenant_id
Reset Quota Reset Quota
Positional arguments **Positional arguments:**
--------------------
``tenant_id`` ``tenant_id``
Tenant ID. Tenant ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -415,8 +391,7 @@ designate quota-update
.. code-block:: console .. code-block:: console
usage: designate quota-update [-h] usage: designate quota-update [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--domains DOMAINS] [--prefix PREFIX] [--domains DOMAINS]
[--domain-recordsets DOMAIN_RECORDSETS] [--domain-recordsets DOMAIN_RECORDSETS]
@ -427,14 +402,12 @@ designate quota-update
Update Quota Update Quota
Positional arguments **Positional arguments:**
--------------------
``tenant_id`` ``tenant_id``
Tenant ID. Tenant ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -461,8 +434,7 @@ designate record-create
.. code-block:: console .. code-block:: console
usage: designate record-create [-h] usage: designate record-create [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] --name NAME [--noindent] [--prefix PREFIX] --name NAME
--type TYPE --data DATA [--ttl TTL] --type TYPE --data DATA [--ttl TTL]
@ -472,14 +444,12 @@ designate record-create
Create Record Create Record
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -509,16 +479,14 @@ designate record-delete
.. code-block:: console .. code-block:: console
usage: designate record-delete [-h] usage: designate record-delete [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
domain_id id domain_id id
Delete Record Delete Record
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID or name. Domain ID or name.
@ -526,8 +494,7 @@ Positional arguments
``id`` ``id``
Record ID. Record ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -539,16 +506,14 @@ designate record-get
.. code-block:: console .. code-block:: console
usage: designate record-get [-h] usage: designate record-get [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
domain_id id domain_id id
Get Record Get Record
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID or name. Domain ID or name.
@ -556,8 +521,7 @@ Positional arguments
``id`` ``id``
Record ID. Record ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -569,22 +533,19 @@ designate record-list
.. code-block:: console .. code-block:: console
usage: designate record-list [-h] usage: designate record-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-f {csv,html,json,json,table,value,yaml,yaml}] [--max-width <integer>] [--noindent]
[-c COLUMN] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
domain_id domain_id
List Records List Records
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID or name. Domain ID or name.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -596,8 +557,7 @@ designate record-update
.. code-block:: console .. code-block:: console
usage: designate record-update [-h] usage: designate record-update [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--name NAME] [--noindent] [--prefix PREFIX] [--name NAME]
[--type TYPE] [--data DATA] [--type TYPE] [--data DATA]
@ -608,8 +568,7 @@ designate record-update
Update Record Update Record
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID or name. Domain ID or name.
@ -617,8 +576,7 @@ Positional arguments
``id`` ``id``
Record ID. Record ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -654,15 +612,13 @@ designate report-count-all
.. code-block:: console .. code-block:: console
usage: designate report-count-all [-h] usage: designate report-count-all [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
Get count totals for all tenants, domains and records Get count totals for all tenants, domains and records
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -674,15 +630,13 @@ designate report-count-domains
.. code-block:: console .. code-block:: console
usage: designate report-count-domains [-h] usage: designate report-count-domains [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
Get counts for total domains Get counts for total domains
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -694,15 +648,13 @@ designate report-count-records
.. code-block:: console .. code-block:: console
usage: designate report-count-records [-h] usage: designate report-count-records [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
Get counts for total records Get counts for total records
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -714,15 +666,13 @@ designate report-count-tenants
.. code-block:: console .. code-block:: console
usage: designate report-count-tenants [-h] usage: designate report-count-tenants [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
Get counts for total tenants Get counts for total tenants
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -734,8 +684,7 @@ designate report-tenant-domains
.. code-block:: console .. code-block:: console
usage: designate report-tenant-domains [-h] usage: designate report-tenant-domains [-h] [-f {csv,json,table,value,yaml}]
[-f {csv,html,json,json,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
@ -743,8 +692,7 @@ designate report-tenant-domains
Get a list of domains for given tenant Get a list of domains for given tenant
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -759,16 +707,14 @@ designate report-tenants-all
.. code-block:: console .. code-block:: console
usage: designate report-tenants-all [-h] usage: designate report-tenants-all [-h] [-f {csv,json,table,value,yaml}]
[-f {csv,html,json,json,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
Get list of tenants and domain count for each Get list of tenants and domain count for each
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -780,15 +726,13 @@ designate server-create
.. code-block:: console .. code-block:: console
usage: designate server-create [-h] usage: designate server-create [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] --name NAME [--noindent] [--prefix PREFIX] --name NAME
Create Server Create Server
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -803,22 +747,19 @@ designate server-delete
.. code-block:: console .. code-block:: console
usage: designate server-delete [-h] usage: designate server-delete [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--noindent] [--prefix PREFIX]
id id
Delete Server Delete Server
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Server ID. Server ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -830,22 +771,19 @@ designate server-get
.. code-block:: console .. code-block:: console
usage: designate server-get [-h] usage: designate server-get [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
id id
Get Server Get Server
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Server ID. Server ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -857,15 +795,13 @@ designate server-list
.. code-block:: console .. code-block:: console
usage: designate server-list [-h] usage: designate server-list [-h] [-f {csv,json,table,value,yaml}] [-c COLUMN]
[-f {csv,html,json,json,table,value,yaml,yaml}] [--max-width <integer>] [--noindent]
[-c COLUMN] [--max-width <integer>] [--noindent]
[--quote {all,minimal,none,nonnumeric}] [--quote {all,minimal,none,nonnumeric}]
List Servers List Servers
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -877,22 +813,19 @@ designate server-update
.. code-block:: console .. code-block:: console
usage: designate server-update [-h] usage: designate server-update [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [-c COLUMN] [--max-width <integer>]
[--noindent] [--prefix PREFIX] [--name NAME] [--noindent] [--prefix PREFIX] [--name NAME]
id id
Update Server Update Server
Positional arguments **Positional arguments:**
--------------------
``id`` ``id``
Server ID. Server ID.
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -907,15 +840,13 @@ designate sync-all
.. code-block:: console .. code-block:: console
usage: designate sync-all [-h] usage: designate sync-all [-h] [-f {json,shell,table,value,yaml}] [-c COLUMN]
[-f {html,json,json,shell,table,value,yaml,yaml}] [--max-width <integer>] [--noindent]
[-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
Sync Everything Sync Everything
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -927,22 +858,19 @@ designate sync-domain
.. code-block:: console .. code-block:: console
usage: designate sync-domain [-h] usage: designate sync-domain [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
domain_id domain_id
Sync a single Domain Sync a single Domain
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID Domain ID
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -954,16 +882,14 @@ designate sync-record
.. code-block:: console .. code-block:: console
usage: designate sync-record [-h] usage: designate sync-record [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
domain_id record_id domain_id record_id
Sync a single Record Sync a single Record
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID Domain ID
@ -971,8 +897,7 @@ Positional arguments
``record_id`` ``record_id``
Record ID Record ID
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit
@ -984,22 +909,19 @@ designate touch-domain
.. code-block:: console .. code-block:: console
usage: designate touch-domain [-h] usage: designate touch-domain [-h] [-f {json,shell,table,value,yaml}]
[-f {html,json,json,shell,table,value,yaml,yaml}]
[-c COLUMN] [--max-width <integer>] [--noindent] [-c COLUMN] [--max-width <integer>] [--noindent]
[--prefix PREFIX] [--prefix PREFIX]
domain_id domain_id
Touch a single Domain Touch a single Domain
Positional arguments **Positional arguments:**
--------------------
``domain_id`` ``domain_id``
Domain ID Domain ID
Optional arguments **Optional arguments:**
------------------
``-h, --help`` ``-h, --help``
show this help message and exit show this help message and exit

262
doc/cli-reference/source/glance.rst
View File

@ -26,9 +26,9 @@ glance usage
usage: glance [--version] [-d] [-v] [--get-schema] [--no-ssl-compression] [-f] usage: glance [--version] [-d] [-v] [--get-schema] [--no-ssl-compression] [-f]
[--os-image-url OS_IMAGE_URL] [--os-image-url OS_IMAGE_URL]
[--os-image-api-version OS_IMAGE_API_VERSION] [--insecure] [--os-image-api-version OS_IMAGE_API_VERSION]
[--os-cacert <ca-certificate>] [--os-cert <certificate>] [--profile HMAC_KEY] [--insecure] [--os-cacert <ca-certificate>]
[--os-key <key>] [--timeout <seconds>] [--os-cert <certificate>] [--os-key <key>] [--timeout <seconds>]
[--os-auth-url OS_AUTH_URL] [--os-domain-id OS_DOMAIN_ID] [--os-auth-url OS_AUTH_URL] [--os-domain-id OS_DOMAIN_ID]
[--os-domain-name OS_DOMAIN_NAME] [--os-domain-name OS_DOMAIN_NAME]
[--os-project-id OS_PROJECT_ID] [--os-project-id OS_PROJECT_ID]
@ -85,6 +85,16 @@ glance optional arguments
``--os-image-api-version OS_IMAGE_API_VERSION`` ``--os-image-api-version OS_IMAGE_API_VERSION``
Defaults to ``env[OS_IMAGE_API_VERSION]`` or 2. Defaults to ``env[OS_IMAGE_API_VERSION]`` or 2.
``--profile HMAC_KEY``
HMAC key to use for encrypting context data for
performance profiling of operation. This key should be
the value of HMAC key configured in osprofiler
middleware in glance, it is specified in paste
configuration file at /etc/glance/api-paste.ini and
/etc/glance/registry-paste.ini. Without key the
profiling will not be triggered even if osprofiler is
enabled on server side.
``--insecure`` ``--insecure``
Explicitly allow client to perform "insecure" TLS Explicitly allow client to perform "insecure" TLS
(https) requests. The server's certificate will not be (https) requests. The server's certificate will not be
@ -195,8 +205,7 @@ glance image-create (v1)
Create a new image. Create a new image.
Optional arguments **Optional arguments:**
------------------
``--id <IMAGE_ID>`` ``--id <IMAGE_ID>``
ID of image to reserve. ID of image to reserve.
@ -278,8 +287,7 @@ glance image-delete (v1)
Delete specified image(s). Delete specified image(s).
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Name or ID of image(s) to delete. Name or ID of image(s) to delete.
@ -295,14 +303,12 @@ glance image-download (v1)
Download a specific image. Download a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Name or ID of image to download. Name or ID of image to download.
Optional arguments **Optional arguments:**
------------------
``--file <FILE>`` ``--file <FILE>``
Local file to save downloaded image data to. If this is not Local file to save downloaded image data to. If this is not
@ -331,8 +337,7 @@ glance image-list (v1)
List images you can access. List images you can access.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
Filter images to those that have this name. Filter images to those that have this name.
@ -406,14 +411,12 @@ glance image-show (v1)
Describe a specific image. Describe a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Name or ID of image to describe. Name or ID of image to describe.
Optional arguments **Optional arguments:**
------------------
``--human-readable`` ``--human-readable``
Print image size in a human-friendly format. Print image size in a human-friendly format.
@ -442,14 +445,12 @@ glance image-update (v1)
Update a specific image. Update a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Name or ID of image to modify. Name or ID of image to modify.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
Name of image. Name of image.
@ -531,8 +532,7 @@ glance member-create (v1)
Share a specific image with a tenant. Share a specific image with a tenant.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Image to add member to. Image to add member to.
@ -540,8 +540,7 @@ Positional arguments
``<TENANT_ID>`` ``<TENANT_ID>``
Tenant to add as member. Tenant to add as member.
Optional arguments **Optional arguments:**
------------------
``--can-share`` ``--can-share``
Allow the specified tenant to share this image. Allow the specified tenant to share this image.
@ -557,8 +556,7 @@ glance member-delete (v1)
Remove a shared image from a tenant. Remove a shared image from a tenant.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE>`` ``<IMAGE>``
Image from which to remove member. Image from which to remove member.
@ -577,8 +575,7 @@ glance member-list (v1)
Describe sharing permissions by image or tenant. Describe sharing permissions by image or tenant.
Optional arguments **Optional arguments:**
------------------
``--image-id <IMAGE_ID>`` ``--image-id <IMAGE_ID>``
Filter results by an image ID. Filter results by an image ID.
@ -609,8 +606,7 @@ glance explain (v2)
Describe a specific model. Describe a specific model.
Positional arguments **Positional arguments:**
--------------------
``<MODEL>`` ``<MODEL>``
Name of model to describe. Name of model to describe.
@ -639,8 +635,7 @@ glance image-create (v2)
Create a new image. Create a new image.
Optional arguments **Optional arguments:**
------------------
``--architecture <ARCHITECTURE>`` ``--architecture <ARCHITECTURE>``
Operating system architecture as specified in Operating system architecture as specified in
@ -725,8 +720,7 @@ glance image-deactivate (v2)
Deactivate specified image. Deactivate specified image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to deactivate. ID of image to deactivate.
@ -742,8 +736,7 @@ glance image-delete (v2)
Delete specified image. Delete specified image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image(s) to delete. ID of image(s) to delete.
@ -759,14 +752,12 @@ glance image-download (v2)
Download a specific image. Download a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to download. ID of image to download.
Optional arguments **Optional arguments:**
------------------
``--file <FILE>`` ``--file <FILE>``
Local file to save downloaded image data to. If this is not Local file to save downloaded image data to. If this is not
@ -793,8 +784,7 @@ glance image-list (v2)
List images you can access. List images you can access.
Optional arguments **Optional arguments:**
------------------
``--limit <LIMIT>`` ``--limit <LIMIT>``
Maximum number of images to get. Maximum number of images to get.
@ -846,8 +836,7 @@ glance image-reactivate (v2)
Reactivate specified image. Reactivate specified image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to reactivate. ID of image to reactivate.
@ -864,14 +853,12 @@ glance image-show (v2)
Describe a specific image. Describe a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to describe. ID of image to describe.
Optional arguments **Optional arguments:**
------------------
``--human-readable`` ``--human-readable``
Print image size in a human-friendly format. Print image size in a human-friendly format.
@ -890,8 +877,7 @@ glance image-tag-delete (v2)
Delete the tag associated with the given image. Delete the tag associated with the given image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of the image from which to delete tag. ID of the image from which to delete tag.
@ -910,8 +896,7 @@ glance image-tag-update (v2)
Update an image with the given tag. Update an image with the given tag.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
Image to be updated with the given tag. Image to be updated with the given tag.
@ -941,14 +926,12 @@ glance image-update (v2)
Update an existing image. Update an existing image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to update. ID of image to update.
Optional arguments **Optional arguments:**
------------------
``--architecture <ARCHITECTURE>`` ``--architecture <ARCHITECTURE>``
Operating system architecture as specified in Operating system architecture as specified in
@ -1024,14 +1007,12 @@ glance image-upload (v2)
Upload data for a specific image. Upload data for a specific image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to upload data to. ID of image to upload data to.
Optional arguments **Optional arguments:**
------------------
``--file <FILE>`` ``--file <FILE>``
Local file that contains disk image to be uploaded. Local file that contains disk image to be uploaded.
@ -1057,14 +1038,12 @@ glance location-add (v2)
Add a location (and related metadata) to an image. Add a location (and related metadata) to an image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image to which the location is to be added. ID of image to which the location is to be added.
Optional arguments **Optional arguments:**
------------------
``--url <URL>`` ``--url <URL>``
URL of location to add. URL of location to add.
@ -1084,14 +1063,12 @@ glance location-delete (v2)
Remove locations (and related metadata) from an image. Remove locations (and related metadata) from an image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image whose locations are to be removed. ID of image whose locations are to be removed.
Optional arguments **Optional arguments:**
------------------
``--url <URL>`` ``--url <URL>``
URL of location to remove. May be used multiple times. URL of location to remove. May be used multiple times.
@ -1107,14 +1084,12 @@ glance location-update (v2)
Update metadata of an image's location. Update metadata of an image's location.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
ID of image whose location is to be updated. ID of image whose location is to be updated.
Optional arguments **Optional arguments:**
------------------
``--url <URL>`` ``--url <URL>``
URL of location to update. URL of location to update.
@ -1134,8 +1109,7 @@ glance md-namespace-create (v2)
Create a new metadata definitions namespace. Create a new metadata definitions namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace. Name of the namespace.
@ -1155,8 +1129,7 @@ glance md-namespace-delete (v2)
Delete specified metadata definitions namespace with its contents. Delete specified metadata definitions namespace with its contents.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace to delete. Name of namespace to delete.
@ -1172,8 +1145,7 @@ glance md-namespace-import (v2)
Import a metadata definitions namespace from file or standard input. Import a metadata definitions namespace from file or standard input.
Optional arguments **Optional arguments:**
------------------
``--file <FILEPATH>`` ``--file <FILEPATH>``
Path to file with namespace schema to import. Path to file with namespace schema to import.
@ -1193,8 +1165,7 @@ glance md-namespace-list (v2)
List metadata definitions namespaces. List metadata definitions namespaces.
Optional arguments **Optional arguments:**
------------------
``--resource-types <RESOURCE_TYPES>`` ``--resource-types <RESOURCE_TYPES>``
Resource type to filter namespaces. Resource type to filter namespaces.
@ -1217,8 +1188,7 @@ glance md-namespace-objects-delete (v2)
Delete all metadata definitions objects inside a specific namespace. Delete all metadata definitions objects inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1234,8 +1204,7 @@ glance md-namespace-properties-delete (v2)
Delete all metadata definitions property inside a specific namespace. Delete all metadata definitions property inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1251,8 +1220,7 @@ glance md-namespace-resource-type-list (v2)
List resource types associated to specific namespace. List resource types associated to specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1271,14 +1239,12 @@ glance md-namespace-show (v2)
Describe a specific metadata definitions namespace. Lists also the namespace Describe a specific metadata definitions namespace. Lists also the namespace
properties, objects and resource type associations. properties, objects and resource type associations.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace to describe. Name of namespace to describe.
Optional arguments **Optional arguments:**
------------------
``--resource-type <RESOURCE_TYPE>`` ``--resource-type <RESOURCE_TYPE>``
Applies prefix of given resource type associated to a Applies prefix of given resource type associated to a
@ -1298,8 +1264,7 @@ glance md-namespace-tags-delete (v2)
Delete all metadata definitions tags inside a specific namespace. Delete all metadata definitions tags inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1315,8 +1280,7 @@ glance md-namespace-update (v2)
Update an existing metadata definitions namespace. Update an existing metadata definitions namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace to update. Name of namespace to update.
@ -1336,14 +1300,12 @@ glance md-object-create (v2)
Create a new metadata definitions object inside a namespace. Create a new metadata definitions object inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the object will belong. Name of namespace the object will belong.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
Internal name of an object. Internal name of an object.
@ -1362,8 +1324,7 @@ glance md-object-delete (v2)
Delete a specific metadata definitions object inside a namespace. Delete a specific metadata definitions object inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the object belongs. Name of namespace the object belongs.
@ -1382,8 +1343,7 @@ glance md-object-list (v2)
List metadata definitions objects inside a specific namespace. List metadata definitions objects inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1400,8 +1360,7 @@ glance md-object-property-show (v2)
Describe a specific metadata definitions property inside an object. Describe a specific metadata definitions property inside an object.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the object belongs. Name of namespace the object belongs.
@ -1412,8 +1371,7 @@ Positional arguments
``<PROPERTY>`` ``<PROPERTY>``
Name of a property. Name of a property.
Optional arguments **Optional arguments:**
------------------
``--max-column-width <integer>`` ``--max-column-width <integer>``
The max column width of the printed table. The max column width of the printed table.
@ -1430,8 +1388,7 @@ glance md-object-show (v2)
Describe a specific metadata definitions object inside a namespace. Describe a specific metadata definitions object inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the object belongs. Name of namespace the object belongs.
@ -1439,8 +1396,7 @@ Positional arguments
``<OBJECT>`` ``<OBJECT>``
Name of an object. Name of an object.
Optional arguments **Optional arguments:**
------------------
``--max-column-width <integer>`` ``--max-column-width <integer>``
The max column width of the printed table. The max column width of the printed table.
@ -1457,8 +1413,7 @@ glance md-object-update (v2)
Update metadata definitions object inside a namespace. Update metadata definitions object inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the object belongs. Name of namespace the object belongs.
@ -1466,8 +1421,7 @@ Positional arguments
``<OBJECT>`` ``<OBJECT>``
Name of an object. Name of an object.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
New name of an object. New name of an object.
@ -1488,14 +1442,12 @@ glance md-property-create (v2)
Create a new metadata definitions property inside a namespace. Create a new metadata definitions property inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the property will belong. Name of namespace the property will belong.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
Internal name of a property. Internal name of a property.
@ -1517,8 +1469,7 @@ glance md-property-delete (v2)
Delete a specific metadata definitions property inside a namespace. Delete a specific metadata definitions property inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the property belongs. Name of namespace the property belongs.
@ -1537,8 +1488,7 @@ glance md-property-list (v2)
List metadata definitions properties inside a specific namespace. List metadata definitions properties inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1555,8 +1505,7 @@ glance md-property-show (v2)
Describe a specific metadata definitions property inside a namespace. Describe a specific metadata definitions property inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the property belongs. Name of namespace the property belongs.
@ -1564,8 +1513,7 @@ Positional arguments
``<PROPERTY>`` ``<PROPERTY>``
Name of a property. Name of a property.
Optional arguments **Optional arguments:**
------------------
``--max-column-width <integer>`` ``--max-column-width <integer>``
The max column width of the printed table. The max column width of the printed table.
@ -1583,8 +1531,7 @@ glance md-property-update (v2)
Update metadata definitions property inside a namespace. Update metadata definitions property inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace the property belongs. Name of namespace the property belongs.
@ -1592,8 +1539,7 @@ Positional arguments
``<PROPERTY>`` ``<PROPERTY>``
Name of a property. Name of a property.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
New name of a property. New name of a property.
@ -1615,8 +1561,7 @@ glance md-resource-type-associate (v2)
Associate resource type with a metadata definitions namespace. Associate resource type with a metadata definitions namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1636,8 +1581,7 @@ glance md-resource-type-deassociate (v2)
Deassociate resource type with a metadata definitions namespace. Deassociate resource type with a metadata definitions namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1667,14 +1611,12 @@ glance md-tag-create (v2)
Add a new metadata definitions tag inside a namespace. Add a new metadata definitions tag inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace the tag will belong to. Name of the namespace the tag will belong to.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
The name of the new tag to add. The name of the new tag to add.
@ -1691,14 +1633,12 @@ glance md-tag-create-multiple (v2)
Create new metadata definitions tags inside a namespace. Create new metadata definitions tags inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace the tags will belong to. Name of the namespace the tags will belong to.
Optional arguments **Optional arguments:**
------------------
``--names <NAMES>`` ``--names <NAMES>``
A comma separated list of tag names. A comma separated list of tag names.
@ -1718,8 +1658,7 @@ glance md-tag-delete (v2)
Delete a specific metadata definitions tag inside a namespace. Delete a specific metadata definitions tag inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace to which the tag belongs. Name of the namespace to which the tag belongs.
@ -1738,8 +1677,7 @@ glance md-tag-list (v2)
List metadata definitions tags inside a specific namespace. List metadata definitions tags inside a specific namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of namespace. Name of namespace.
@ -1755,8 +1693,7 @@ glance md-tag-show (v2)
Describe a specific metadata definitions tag inside a namespace. Describe a specific metadata definitions tag inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace to which the tag belongs. Name of the namespace to which the tag belongs.
@ -1775,8 +1712,7 @@ glance md-tag-update (v2)
Rename a metadata definitions tag inside a namespace. Rename a metadata definitions tag inside a namespace.
Positional arguments **Positional arguments:**
--------------------
``<NAMESPACE>`` ``<NAMESPACE>``
Name of the namespace to which the tag belongs. Name of the namespace to which the tag belongs.
@ -1784,8 +1720,7 @@ Positional arguments
``<TAG>`` ``<TAG>``
Name of the old tag. Name of the old tag.
Optional arguments **Optional arguments:**
------------------
``--name <NAME>`` ``--name <NAME>``
New name of the new tag. New name of the new tag.
@ -1801,8 +1736,7 @@ glance member-create (v2)
Create member for a given image. Create member for a given image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
Image with which to create member. Image with which to create member.
@ -1821,8 +1755,7 @@ glance member-delete (v2)
Delete image member. Delete image member.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
Image from which to remove member. Image from which to remove member.
@ -1841,8 +1774,7 @@ glance member-list (v2)
Describe sharing permissions by image. Describe sharing permissions by image.
Optional arguments **Optional arguments:**
------------------
``--image-id <IMAGE_ID>`` ``--image-id <IMAGE_ID>``
Image to display members of. Image to display members of.
@ -1858,8 +1790,7 @@ glance member-update (v2)
Update the status of a member for a given image. Update the status of a member for a given image.
Positional arguments **Positional arguments:**
--------------------
``<IMAGE_ID>`` ``<IMAGE_ID>``
Image from which to update member. Image from which to update member.
@ -1882,8 +1813,7 @@ glance task-create (v2)
Create a new task. Create a new task.
Optional arguments **Optional arguments:**
------------------
``--type <TYPE>`` ``--type <TYPE>``
Type of Task. Please refer to Glance schema or Type of Task. Please refer to Glance schema or
@ -1905,8 +1835,7 @@ glance task-list (v2)
List tasks you can access. List tasks you can access.
Optional arguments **Optional arguments:**
------------------
``--sort-key {id,type,status}`` ``--sort-key {id,type,status}``
Sort task list by specified field. Sort task list by specified field.
@ -1934,8 +1863,7 @@ glance task-show (v2)
Describe a specific task. Describe a specific task.
Positional arguments **Positional arguments:**
--------------------
``<TASK_ID>`` ``<TASK_ID>``
ID of task to describe. ID of task to describe.

209
doc/cli-reference/source/heat.rst
View File

@ -40,11 +40,10 @@ heat usage
[--os-tenant-name OS_TENANT_NAME] [--os-auth-url OS_AUTH_URL] [--os-tenant-name OS_TENANT_NAME] [--os-auth-url OS_AUTH_URL]
[--os-region-name OS_REGION_NAME] [--os-auth-token OS_AUTH_TOKEN] [--os-region-name OS_REGION_NAME] [--os-auth-token OS_AUTH_TOKEN]
[--os-service-type OS_SERVICE_TYPE] [--os-service-type OS_SERVICE_TYPE]
[--os-endpoint-type OS_ENDPOINT_TYPE] [--os-endpoint-type OS_ENDPOINT_TYPE] [--profile HMAC_KEY]
<subcommand> ... <subcommand> ...
Subcommands **Subcommands:**
-----------
``action-check`` ``action-check``
Check that stack resources are in expected states. Check that stack resources are in expected states.
@ -314,6 +313,15 @@ heat optional arguments
``--os-endpoint-type OS_ENDPOINT_TYPE`` ``--os-endpoint-type OS_ENDPOINT_TYPE``
Defaults to ``env[OS_ENDPOINT_TYPE]``. Defaults to ``env[OS_ENDPOINT_TYPE]``.
``--profile HMAC_KEY``
HMAC key to use for encrypting context data for
performance profiling of operation. This key should be
the value of HMAC key configured in osprofiler
middleware in heat, it is specified in the paste
configuration (/etc/heat/api-paste.ini). Without the
key, profiling will not be triggered even if
osprofiler is enabled on server side.
.. _heat_action-check: .. _heat_action-check:
heat action-check heat action-check
@ -325,8 +333,7 @@ heat action-check
Check that stack resources are in expected states. Check that stack resources are in expected states.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to check. Name or ID of stack to check.
@ -342,8 +349,7 @@ heat action-resume
Resume the stack. Resume the stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to resume. Name or ID of stack to resume.
@ -359,8 +365,7 @@ heat action-suspend
Suspend the stack. Suspend the stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to suspend. Name or ID of stack to suspend.
@ -389,14 +394,12 @@ heat config-create
Create a software configuration. Create a software configuration.
Positional arguments **Positional arguments:**
--------------------
``<CONFIG_NAME>`` ``<CONFIG_NAME>``
Name of the configuration to create. Name of the configuration to create.
Optional arguments **Optional arguments:**
------------------
``-f <FILE or URL>, --definition-file <FILE or URL>`` ``-f <FILE or URL>, --definition-file <FILE or URL>``
Path to JSON/YAML containing map defining <inputs>, Path to JSON/YAML containing map defining <inputs>,
@ -420,8 +423,7 @@ heat config-delete
Delete the software configuration(s). Delete the software configuration(s).
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID of the configuration(s) to delete. ID of the configuration(s) to delete.
@ -437,8 +439,7 @@ heat config-list
List software configs. List software configs.
Optional arguments **Optional arguments:**
------------------
``-l <LIMIT>, --limit <LIMIT>`` ``-l <LIMIT>, --limit <LIMIT>``
Limit the number of configs returned. Limit the number of configs returned.
@ -457,14 +458,12 @@ heat config-show
View details of a software configuration. View details of a software configuration.
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID of the config. ID of the config.
Optional arguments **Optional arguments:**
------------------
``-c, --config-only`` ``-c, --config-only``
Only display the value of the <config> property. Only display the value of the <config> property.
@ -484,8 +483,7 @@ heat deployment-create
Create a software deployment. Create a software deployment.
Positional arguments **Positional arguments:**
--------------------
``<DEPLOY_NAME>`` ``<DEPLOY_NAME>``
Name of the derived config associated with this Name of the derived config associated with this
@ -493,8 +491,7 @@ Positional arguments
list of configurations currently deployed to the list of configurations currently deployed to the
server. server.
Optional arguments **Optional arguments:**
------------------
``-i <KEY=VALUE>, --input-value <KEY=VALUE>`` ``-i <KEY=VALUE>, --input-value <KEY=VALUE>``
Input value to set on the deployment. This can be Input value to set on the deployment. This can be
@ -537,8 +534,7 @@ heat deployment-delete
Delete the software deployment(s). Delete the software deployment(s).
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID of the deployment(s) to delete. ID of the deployment(s) to delete.
@ -554,8 +550,7 @@ heat deployment-list
List software deployments. List software deployments.
Optional arguments **Optional arguments:**
------------------
``-s <SERVER>, --server <SERVER>`` ``-s <SERVER>, --server <SERVER>``
ID of the server to fetch deployments for. ID of the server to fetch deployments for.
@ -571,8 +566,7 @@ heat deployment-metadata-show
Get deployment configuration metadata for the specified server. Get deployment configuration metadata for the specified server.
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID of the server to fetch deployments for. ID of the server to fetch deployments for.
@ -588,8 +582,7 @@ heat deployment-output-show
Show a specific deployment output. Show a specific deployment output.
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID deployment to show the output for. ID deployment to show the output for.
@ -597,8 +590,7 @@ Positional arguments
``<OUTPUT NAME>`` ``<OUTPUT NAME>``
Name of an output to display. Name of an output to display.
Optional arguments **Optional arguments:**
------------------
``-a, --all`` ``-a, --all``
Display all deployment outputs. Display all deployment outputs.
@ -617,8 +609,7 @@ heat deployment-show
Show the details of a software deployment. Show the details of a software deployment.
Positional arguments **Positional arguments:**
--------------------
``<ID>`` ``<ID>``
ID of the deployment. ID of the deployment.
@ -636,14 +627,12 @@ heat event-list
List events for a stack. List events for a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the events for. Name or ID of stack to show the events for.
Optional arguments **Optional arguments:**
------------------
``-r <RESOURCE>, --resource <RESOURCE>`` ``-r <RESOURCE>, --resource <RESOURCE>``
Name of the resource to filter events by. Name of the resource to filter events by.
@ -678,8 +667,7 @@ heat event-show
Describe the event. Describe the event.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the events for. Name or ID of stack to show the events for.
@ -702,8 +690,7 @@ heat hook-clear
Clear hooks on a given stack. Clear hooks on a given stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of the stack these resources belong to. Name or ID of the stack these resources belong to.
@ -715,8 +702,7 @@ Positional arguments
match multiple stacks or resources: match multiple stacks or resources:
nested_stack/an\*/\*_resource nested_stack/an\*/\*_resource
Optional arguments **Optional arguments:**
------------------
``--pre-create`` ``--pre-create``
Clear the pre-create hooks (optional) Clear the pre-create hooks (optional)
@ -735,14 +721,12 @@ heat hook-poll
List resources with pending hook for a stack. List resources with pending hook for a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the pending hooks for. Name or ID of stack to show the pending hooks for.
Optional arguments **Optional arguments:**
------------------
``-n <DEPTH>, --nested-depth <DEPTH>`` ``-n <DEPTH>, --nested-depth <DEPTH>``
Depth of nested stacks from which to display hooks. Depth of nested stacks from which to display hooks.
@ -758,8 +742,7 @@ heat output-list
Show available outputs. Show available outputs.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to query. Name or ID of stack to query.
@ -776,8 +759,7 @@ heat output-show
Show a specific stack output. Show a specific stack output.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to query. Name or ID of stack to query.
@ -785,8 +767,7 @@ Positional arguments
``<OUTPUT NAME>`` ``<OUTPUT NAME>``
Name of an output to display. Name of an output to display.
Optional arguments **Optional arguments:**
------------------
``-F <FORMAT>, --format <FORMAT>`` ``-F <FORMAT>, --format <FORMAT>``
The output value format, one of: json, raw. The output value format, one of: json, raw.
@ -810,14 +791,12 @@ heat resource-list
Show list of resources belonging to a stack. Show list of resources belonging to a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the resources for. Name or ID of stack to show the resources for.
Optional arguments **Optional arguments:**
------------------
``-n <DEPTH>, --nested-depth <DEPTH>`` ``-n <DEPTH>, --nested-depth <DEPTH>``
Depth of nested stacks from which to display Depth of nested stacks from which to display
@ -844,8 +823,7 @@ heat resource-mark-unhealthy
Set resource's health. Set resource's health.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack the resource belongs to. Name or ID of stack the resource belongs to.
@ -856,8 +834,7 @@ Positional arguments
``reason`` ``reason``
Reason for state change. Reason for state change.
Optional arguments **Optional arguments:**
------------------
``--reset`` ``--reset``
Set the resource as healthy. Set the resource as healthy.
@ -873,8 +850,7 @@ heat resource-metadata
List resource metadata. List resource metadata.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the resource metadata for. Name or ID of stack to show the resource metadata for.
@ -893,8 +869,7 @@ heat resource-show
Describe the resource. Describe the resource.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to show the resource for. Name or ID of stack to show the resource for.
@ -902,8 +877,7 @@ Positional arguments
``<RESOURCE>`` ``<RESOURCE>``
Name of the resource to show the details for. Name of the resource to show the details for.
Optional arguments **Optional arguments:**
------------------
``-a <ATTRIBUTE>, --with-attr <ATTRIBUTE>`` ``-a <ATTRIBUTE>, --with-attr <ATTRIBUTE>``
Attribute to show, it can be specified multiple times. Attribute to show, it can be specified multiple times.
@ -919,8 +893,7 @@ heat resource-signal
Send a signal to a resource. Send a signal to a resource.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack the resource belongs to. Name or ID of stack the resource belongs to.
@ -928,8 +901,7 @@ Positional arguments
``<RESOURCE>`` ``<RESOURCE>``
Name of the resource to signal. Name of the resource to signal.
Optional arguments **Optional arguments:**
------------------
``-D <DATA>, --data <DATA>`` ``-D <DATA>, --data <DATA>``
JSON Data to send to the signal handler. JSON Data to send to the signal handler.
@ -949,8 +921,7 @@ heat resource-type-list
List the available resource types. List the available resource types.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned resource types. Filter parameters to apply on returned resource types.
@ -969,8 +940,7 @@ heat resource-type-show
Show the resource type. Show the resource type.
Positional arguments **Positional arguments:**
--------------------
``<RESOURCE_TYPE>`` ``<RESOURCE_TYPE>``
Resource type to get the details for. Resource type to get the details for.
@ -987,14 +957,12 @@ heat resource-type-template
Generate a template based on a resource type. Generate a template based on a resource type.
Positional arguments **Positional arguments:**
--------------------
``<RESOURCE_TYPE>`` ``<RESOURCE_TYPE>``
Resource type to generate a template for. Resource type to generate a template for.
Optional arguments **Optional arguments:**
------------------
``-t <TEMPLATE_TYPE>, --template-type <TEMPLATE_TYPE>`` ``-t <TEMPLATE_TYPE>, --template-type <TEMPLATE_TYPE>``
Template type to generate, hot or cfn. Template type to generate, hot or cfn.
@ -1024,8 +992,7 @@ heat snapshot-delete
Delete a snapshot of a stack. Delete a snapshot of a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of the stack containing the snapshot. Name or ID of the stack containing the snapshot.
@ -1044,8 +1011,7 @@ heat snapshot-list
List the snapshots of a stack. List the snapshots of a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of the stack containing the snapshots. Name or ID of the stack containing the snapshots.
@ -1061,8 +1027,7 @@ heat snapshot-show
Show a snapshot of a stack. Show a snapshot of a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of the stack containing the snapshot. Name or ID of the stack containing the snapshot.
@ -1083,14 +1048,12 @@ Abandon the stack. This will delete the record of the stack from Heat, but
will not delete any of the underlying resources. Prints an adoptable JSON will not delete any of the underlying resources. Prints an adoptable JSON
representation of the stack to stdout or a file on success. representation of the stack to stdout or a file on success.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to abandon. Name or ID of stack to abandon.
Optional arguments **Optional arguments:**
------------------
``-O <FILE>, --output-file <FILE>`` ``-O <FILE>, --output-file <FILE>``
file to output abandon result. If the option is file to output abandon result. If the option is
@ -1110,14 +1073,12 @@ heat stack-adopt
Adopt a stack. Adopt a stack.
Positional arguments **Positional arguments:**
--------------------
``<STACK_NAME>`` ``<STACK_NAME>``
Name of the stack to adopt. Name of the stack to adopt.
Optional arguments **Optional arguments:**
------------------
``-e <FILE or URL>, --environment-file <FILE or URL>`` ``-e <FILE or URL>, --environment-file <FILE or URL>``
Path to the environment, it can be specified multiple Path to the environment, it can be specified multiple
@ -1152,8 +1113,7 @@ heat stack-cancel-update
Cancel currently running update of the stack. Cancel currently running update of the stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to cancel update for. Name or ID of stack to cancel update for.
@ -1174,14 +1134,12 @@ heat stack-create
Create the stack. Create the stack.
Positional arguments **Positional arguments:**
--------------------
``<STACK_NAME>`` ``<STACK_NAME>``
Name of the stack to create. Name of the stack to create.
Optional arguments **Optional arguments:**
------------------
``-f <FILE>, --template-file <FILE>`` ``-f <FILE>, --template-file <FILE>``
Path to the template. Path to the template.
@ -1243,14 +1201,12 @@ heat stack-delete
Delete the stack(s). Delete the stack(s).
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack(s) to delete. Name or ID of stack(s) to delete.
Optional arguments **Optional arguments:**
------------------
``-y, --yes`` ``-y, --yes``
Skip yes/no prompt (assume yes). Skip yes/no prompt (assume yes).
@ -1270,8 +1226,7 @@ heat stack-list
List the user's stacks. List the user's stacks.
Optional arguments **Optional arguments:**
------------------
``-s, --show-deleted`` ``-s, --show-deleted``
Include soft-deleted stacks in the stack listing. Include soft-deleted stacks in the stack listing.
@ -1345,14 +1300,12 @@ heat stack-preview
Preview the stack. Preview the stack.
Positional arguments **Positional arguments:**
--------------------
``<STACK_NAME>`` ``<STACK_NAME>``
Name of the stack to preview. Name of the stack to preview.
Optional arguments **Optional arguments:**
------------------
``-f <FILE>, --template-file <FILE>`` ``-f <FILE>, --template-file <FILE>``
Path to the template. Path to the template.
@ -1400,8 +1353,7 @@ heat stack-restore
Restore a snapshot of a stack. Restore a snapshot of a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of the stack containing the snapshot. Name or ID of the stack containing the snapshot.
@ -1420,14 +1372,12 @@ heat stack-show
Describe the stack. Describe the stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to describe. Name or ID of stack to describe.
Optional arguments **Optional arguments:**
------------------
``--no-resolve-outputs`` ``--no-resolve-outputs``
Do not resolve outputs of the stack. Do not resolve outputs of the stack.
@ -1443,14 +1393,12 @@ heat stack-snapshot
Make a snapshot of a stack. Make a snapshot of a stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to snapshot. Name or ID of stack to snapshot.
Optional arguments **Optional arguments:**
------------------
``-n <NAME>, --name <NAME>`` ``-n <NAME>, --name <NAME>``
If specified, the name given to the snapshot. If specified, the name given to the snapshot.
@ -1471,14 +1419,12 @@ heat stack-update
Update the stack. Update the stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to update. Name or ID of stack to update.
Optional arguments **Optional arguments:**
------------------
``-f <FILE>, --template-file <FILE>`` ``-f <FILE>, --template-file <FILE>``
Path to the template. Path to the template.
@ -1564,8 +1510,7 @@ heat template-function-list
List the available functions. List the available functions.
Positional arguments **Positional arguments:**
--------------------
``<TEMPLATE_VERSION>`` ``<TEMPLATE_VERSION>``
Template version to get the functions for. Template version to get the functions for.
@ -1581,8 +1526,7 @@ heat template-show
Get the template for the specified stack. Get the template for the specified stack.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of stack to get the template for. Name or ID of stack to get the template for.
@ -1601,8 +1545,7 @@ heat template-validate
Validate a template with parameters. Validate a template with parameters.
Optional arguments **Optional arguments:**
------------------
``-u <URL>, --template-url <URL>`` ``-u <URL>, --template-url <URL>``
URL of template. URL of template.

408
doc/cli-reference/source/mistral.rst
View File

File diff suppressed because it is too large Load Diff

206
doc/cli-reference/source/senlin.rst
View File

@ -41,11 +41,10 @@ senlin usage
[--os-api-name <service>=<name>] [--os-api-name <service>=<name>]
[--os-api-region <service>=<region>] [--os-api-region <service>=<region>]
[--os-api-version <service>=<version>] [--os-api-version <service>=<version>]
[--os-api-interface <service>=<interface>] [--os-api-interface <service>=<interface>] [--profile HMAC_KEY]
<subcommand> ... <subcommand> ...
Subcommands **Subcommands:**
-----------
``action-list`` ``action-list``
List actions. List actions.
@ -295,6 +294,15 @@ senlin optional arguments
``--os-api-interface <service>=<interface>`` ``--os-api-interface <service>=<interface>``
Desired API interface, defaults to ``env[OS_INTERFACE]`` Desired API interface, defaults to ``env[OS_INTERFACE]``
``--profile HMAC_KEY``
HMAC key to use for encrypting context data for
performance profiling of operation. This key should be
the value of HMAC key configured in osprofiler
middleware in senlin, it is specified in the paste
deploy configuration (/etc/senlin/api-paste.ini).
Without the key, profiling will not be triggered even
if osprofiler is enabled on server side.
.. _senlin_action-list: .. _senlin_action-list:
senlin action-list senlin action-list
@ -307,8 +315,7 @@ senlin action-list
List actions. List actions.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned actions. This Filter parameters to apply on returned actions. This
@ -341,8 +348,7 @@ senlin action-show
Show detailed info about the specified action. Show detailed info about the specified action.
Positional arguments **Positional arguments:**
--------------------
``<ACTION>`` ``<ACTION>``
Name or ID of the action to show the details for. Name or ID of the action to show the details for.
@ -373,14 +379,12 @@ senlin cluster-create
Create the cluster. Create the cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER_NAME>`` ``<CLUSTER_NAME>``
Name of the cluster to create. Name of the cluster to create.
Optional arguments **Optional arguments:**
------------------
``-p <PROFILE>, --profile <PROFILE>`` ``-p <PROFILE>, --profile <PROFILE>``
Profile Id used for this cluster. Profile Id used for this cluster.
@ -415,8 +419,7 @@ senlin cluster-delete
Delete the cluster(s). Delete the cluster(s).
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster(s) to delete. Name or ID of cluster(s) to delete.
@ -433,8 +436,7 @@ senlin cluster-list
List the user's clusters. List the user's clusters.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned clusters. This Filter parameters to apply on returned clusters. This
@ -472,14 +474,12 @@ senlin cluster-node-add
Add specified nodes to cluster. Add specified nodes to cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-n <NODES>, --nodes <NODES>`` ``-n <NODES>, --nodes <NODES>``
ID of nodes to be added; multiple nodes can be ID of nodes to be added; multiple nodes can be
@ -496,14 +496,12 @@ senlin cluster-node-del
Delete specified nodes from cluster. Delete specified nodes from cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-n <NODES>, --nodes <NODES>`` ``-n <NODES>, --nodes <NODES>``
ID of nodes to be deleted; multiple nodes can be ID of nodes to be deleted; multiple nodes can be
@ -522,14 +520,12 @@ senlin cluster-node-list
List nodes from cluster. List nodes from cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to nodes from. Name or ID of cluster to nodes from.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned nodes. This can Filter parameters to apply on returned nodes. This can
@ -556,14 +552,12 @@ senlin cluster-policy-attach
Attach policy to cluster. Attach policy to cluster.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-p <POLICY>, --policy <POLICY>`` ``-p <POLICY>, --policy <POLICY>``
ID or name of policy to be attached. ID or name of policy to be attached.
@ -583,14 +577,12 @@ senlin cluster-policy-detach
Detach policy from cluster. Detach policy from cluster.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-p <POLICY>, --policy <POLICY>`` ``-p <POLICY>, --policy <POLICY>``
ID or name of policy to be detached. ID or name of policy to be detached.
@ -608,14 +600,12 @@ senlin cluster-policy-list
List policies from cluster. List policies from cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to query on. Name or ID of cluster to query on.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned results. This Filter parameters to apply on returned results. This
@ -641,14 +631,12 @@ senlin cluster-policy-show
Show a specific policy that is bound to the specified cluster. Show a specific policy that is bound to the specified cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
ID or name of the cluster to query on. ID or name of the cluster to query on.
Optional arguments **Optional arguments:**
------------------
``-p <POLICY>, --policy <POLICY>`` ``-p <POLICY>, --policy <POLICY>``
ID or name of the policy to query on. ID or name of the policy to query on.
@ -664,14 +652,12 @@ senlin cluster-policy-update
Update a policy's properties on a cluster. Update a policy's properties on a cluster.
Positional arguments **Positional arguments:**
--------------------
``<NAME or ID>`` ``<NAME or ID>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-p <POLICY>, --policy <POLICY>`` ``-p <POLICY>, --policy <POLICY>``
ID or name of policy to be updated. ID or name of policy to be updated.
@ -693,14 +679,12 @@ senlin cluster-resize
Resize a cluster. Resize a cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-c <CAPACITY>, --capacity <CAPACITY>`` ``-c <CAPACITY>, --capacity <CAPACITY>``
The desired number of nodes of the cluster. The desired number of nodes of the cluster.
@ -741,14 +725,12 @@ senlin cluster-scale-in
Scale in a cluster by the specified number of nodes. Scale in a cluster by the specified number of nodes.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-c <COUNT>, --count <COUNT>`` ``-c <COUNT>, --count <COUNT>``
Number of nodes to be deleted from the specified Number of nodes to be deleted from the specified
@ -765,14 +747,12 @@ senlin cluster-scale-out
Scale out a cluster by the specified number of nodes. Scale out a cluster by the specified number of nodes.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to operate on. Name or ID of cluster to operate on.
Optional arguments **Optional arguments:**
------------------
``-c <COUNT>, --count <COUNT>`` ``-c <COUNT>, --count <COUNT>``
Number of nodes to be added to the specified cluster. Number of nodes to be added to the specified cluster.
@ -788,8 +768,7 @@ senlin cluster-show
Show details of the cluster. Show details of the cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to show. Name or ID of cluster to show.
@ -807,14 +786,12 @@ senlin cluster-update
Update the cluster. Update the cluster.
Positional arguments **Positional arguments:**
--------------------
``<CLUSTER>`` ``<CLUSTER>``
Name or ID of cluster to be updated. Name or ID of cluster to be updated.
Optional arguments **Optional arguments:**
------------------
``-p <PROFILE>, --profile <PROFILE>`` ``-p <PROFILE>, --profile <PROFILE>``
ID of new profile to use. ID of new profile to use.
@ -842,8 +819,7 @@ senlin event-list
List events. List events.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned events. This Filter parameters to apply on returned events. This
@ -881,8 +857,7 @@ senlin event-show
Describe the event. Describe the event.
Positional arguments **Positional arguments:**
--------------------
``<EVENT>`` ``<EVENT>``
ID of event to display details for. ID of event to display details for.
@ -900,14 +875,12 @@ senlin node-create
Create the node. Create the node.
Positional arguments **Positional arguments:**
--------------------
``<NODE_NAME>`` ``<NODE_NAME>``
Name of the node to create. Name of the node to create.
Optional arguments **Optional arguments:**
------------------
``-p <PROFILE>, --profile <PROFILE>`` ``-p <PROFILE>, --profile <PROFILE>``
Profile Id used for this node. Profile Id used for this node.
@ -934,8 +907,7 @@ senlin node-delete
Delete the node(s). Delete the node(s).
Positional arguments **Positional arguments:**
--------------------
``<NODE>`` ``<NODE>``
Name or ID of node(s) to delete. Name or ID of node(s) to delete.
@ -952,8 +924,7 @@ senlin node-list
Show list of nodes. Show list of nodes.
Optional arguments **Optional arguments:**
------------------
``-c <CLUSTER>, --cluster <CLUSTER>`` ``-c <CLUSTER>, --cluster <CLUSTER>``
ID or name of cluster from which nodes are to be ID or name of cluster from which nodes are to be
@ -994,14 +965,12 @@ senlin node-show
Show detailed info about the specified node. Show detailed info about the specified node.
Positional arguments **Positional arguments:**
--------------------
``<NODE>`` ``<NODE>``
Name or ID of the node to show the details for. Name or ID of the node to show the details for.
Optional arguments **Optional arguments:**
------------------
``-D, --details`` ``-D, --details``
Include physical object details. Include physical object details.
@ -1019,14 +988,12 @@ senlin node-update
Update the node. Update the node.
Positional arguments **Positional arguments:**
--------------------
``<NODE>`` ``<NODE>``
Name or ID of node to update. Name or ID of node to update.
Optional arguments **Optional arguments:**
------------------
``-n <NAME>, --name <NAME>`` ``-n <NAME>, --name <NAME>``
New name for the node. New name for the node.
@ -1053,14 +1020,12 @@ senlin policy-create
Create a policy. Create a policy.
Positional arguments **Positional arguments:**
--------------------
``<NAME>`` ``<NAME>``
Name of the policy to create. Name of the policy to create.
Optional arguments **Optional arguments:**
------------------
``-s <SPEC_FILE>, --spec-file <SPEC_FILE>`` ``-s <SPEC_FILE>, --spec-file <SPEC_FILE>``
The spec file used to create the policy. The spec file used to create the policy.
@ -1076,8 +1041,7 @@ senlin policy-delete
Delete policy(s). Delete policy(s).
Positional arguments **Positional arguments:**
--------------------
``<POLICY>`` ``<POLICY>``
Name or ID of policy(s) to delete. Name or ID of policy(s) to delete.
@ -1094,8 +1058,7 @@ senlin policy-list
List policies that meet the criteria. List policies that meet the criteria.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned policies. This Filter parameters to apply on returned policies. This
@ -1132,8 +1095,7 @@ senlin policy-show
Show the policy details. Show the policy details.
Positional arguments **Positional arguments:**
--------------------
``<POLICY>`` ``<POLICY>``
Name of the policy to be updated. Name of the policy to be updated.
@ -1160,14 +1122,12 @@ senlin policy-type-show
Get the details about a policy type. Get the details about a policy type.
Positional arguments **Positional arguments:**
--------------------
``<TYPE_NAME>`` ``<TYPE_NAME>``
Policy type to retrieve. Policy type to retrieve.
Optional arguments **Optional arguments:**
------------------
``-F <FORMAT>, --format <FORMAT>`` ``-F <FORMAT>, --format <FORMAT>``
The template output format, one of: yaml, json. The template output format, one of: yaml, json.
@ -1183,14 +1143,12 @@ senlin policy-update
Update a policy. Update a policy.
Positional arguments **Positional arguments:**
--------------------
``<POLICY>`` ``<POLICY>``
Name of the policy to be updated. Name of the policy to be updated.
Optional arguments **Optional arguments:**
------------------
``-n <NAME>, --name <NAME>`` ``-n <NAME>, --name <NAME>``
New name of the policy to be updated. New name of the policy to be updated.
@ -1207,14 +1165,12 @@ senlin profile-create
Create a profile. Create a profile.
Positional arguments **Positional arguments:**
--------------------
``<PROFILE_NAME>`` ``<PROFILE_NAME>``
Name of the profile to create. Name of the profile to create.
Optional arguments **Optional arguments:**
------------------
``-s <SPEC FILE>, --spec-file <SPEC FILE>`` ``-s <SPEC FILE>, --spec-file <SPEC FILE>``
The spec file used to create the profile. The spec file used to create the profile.
@ -1235,8 +1191,7 @@ senlin profile-delete
Delete profile(s). Delete profile(s).
Positional arguments **Positional arguments:**
--------------------
``<PROFILE>`` ``<PROFILE>``
Name or ID of profile(s) to delete. Name or ID of profile(s) to delete.
@ -1253,8 +1208,7 @@ senlin profile-list
List profiles that meet the criteria. List profiles that meet the criteria.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned profiles. This Filter parameters to apply on returned profiles. This
@ -1291,8 +1245,7 @@ senlin profile-show
Show the profile details. Show the profile details.
Positional arguments **Positional arguments:**
--------------------
``<PROFILE>`` ``<PROFILE>``
Name or ID of profile to show. Name or ID of profile to show.
@ -1320,14 +1273,12 @@ senlin profile-type-show
Get the details about a profile type. Get the details about a profile type.
Positional arguments **Positional arguments:**
--------------------
``<TYPE_NAME>`` ``<TYPE_NAME>``
Profile type to retrieve. Profile type to retrieve.
Optional arguments **Optional arguments:**
------------------
``-F <FORMAT>, --format <FORMAT>`` ``-F <FORMAT>, --format <FORMAT>``
The template output format, one of: yaml, json. The template output format, one of: yaml, json.
@ -1344,14 +1295,12 @@ senlin profile-update
Update a profile. Update a profile.
Positional arguments **Positional arguments:**
--------------------
``<PROFILE_ID>`` ``<PROFILE_ID>``
Name or ID of the profile to update. Name or ID of the profile to update.
Optional arguments **Optional arguments:**
------------------
``-n <NAME>, --name <NAME>`` ``-n <NAME>, --name <NAME>``
The new name for the profile. The new name for the profile.
@ -1374,14 +1323,12 @@ senlin receiver-create
Create a receiver. Create a receiver.
Positional arguments **Positional arguments:**
--------------------
``<NAME>`` ``<NAME>``
Name of the receiver to create. Name of the receiver to create.
Optional arguments **Optional arguments:**
------------------
``-t <TYPE>, --type <TYPE>`` ``-t <TYPE>, --type <TYPE>``
Type of the receiver to create. Type of the receiver to create.
@ -1407,8 +1354,7 @@ senlin receiver-delete
Delete receiver(s). Delete receiver(s).
Positional arguments **Positional arguments:**
--------------------
``<RECEIVER>`` ``<RECEIVER>``
Name or ID of receiver(s) to delete. Name or ID of receiver(s) to delete.
@ -1425,8 +1371,7 @@ senlin receiver-list
List receivers that meet the criteria. List receivers that meet the criteria.
Optional arguments **Optional arguments:**
------------------
``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>`` ``-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>``
Filter parameters to apply on returned receivers. This Filter parameters to apply on returned receivers. This
@ -1463,8 +1408,7 @@ senlin receiver-show
Show the receiver details. Show the receiver details.
Positional arguments **Positional arguments:**
--------------------
``<RECEIVER>`` ``<RECEIVER>``
Name or ID of the receiver to show. Name or ID of the receiver to show.