Este conteúdo não está disponível no idioma selecionado.
Chapter 74. stack
			This chapter describes the commands under the stack command.
		
74.1. stack abandon
Abandon stack and output results.
Usage:
openstack stack abandon [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--noindent] [--prefix PREFIX]
                               [--max-width <integer>] [--fit-width]
                               [--print-empty] [--output-file <output-file>]
                               <stack>
openstack stack abandon [-h] [-f {json,shell,table,value,yaml}]
                               [-c COLUMN] [--noindent] [--prefix PREFIX]
                               [--max-width <integer>] [--fit-width]
                               [--print-empty] [--output-file <output-file>]
                               <stack>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to abandon | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --output-file <output-file> | File to output abandon results | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to json | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.2. stack adopt
Adopt a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack-name> | Name of the stack to adopt | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| -e <environment>, --environment <environment> | Path to the environment. can be specified multiple times | 
| --timeout <timeout> | Stack creation timeout in minutes | 
| --enable-rollback | Enable rollback on create/update failure | 
| --parameter <key=value> | Parameter values used to create the stack. can be specified multiple times | 
| --wait | Wait until stack adopt completes | 
| --adopt-file <adopt-file> | Path to adopt stack data file | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.3. stack cancel
Cancel current task for a stack. Supported tasks for cancellation: * update * create
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack(s) to cancel (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --wait | Wait for cancel to complete | 
| --no-rollback | Cancel without rollback | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.4. stack check
Check a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack(s) to check update (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --wait | Wait for check to complete | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.5. stack create
Create a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack-name> | Name of the stack to create | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| -e <environment>, --environment <environment> | Path to the environment. can be specified multiple times | 
| --timeout <timeout> | Stack creating timeout in minutes | 
| --pre-create <resource> | Name of a resource to set a pre-create hook to. Resources in nested stacks can be set using slash as a separator: ``nested_stack/another/my_resource``. You can use wildcards to match multiple stacks or resources: ``nested_stack/an*/*_resource``. This can be specified multiple times | 
| --enable-rollback | Enable rollback on create/update failure | 
| --parameter <key=value> | Parameter values used to create the stack. this can be specified multiple times | 
| --parameter-file <key=file> | Parameter values from file used to create the stack. This can be specified multiple times. Parameter values would be the content of the file | 
| --wait | Wait until stack goes to create_complete or CREATE_FAILED | 
| --tags <tag1,tag2…> | A list of tags to associate with the stack | 
| --dry-run | Do not actually perform the stack create, but show what would be created | 
| -t <template>, --template <template> | Path to the template | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.6. stack delete
Delete stack(s).
Usage:
openstack stack delete [-h] [-y] [--wait] <stack> [<stack> ...]
openstack stack delete [-h] [-y] [--wait] <stack> [<stack> ...]| Value | Summary | 
|---|---|
| <stack> | Stack(s) to delete (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| -y, --yes | Skip yes/no prompt (assume yes) | 
| --wait | Wait for stack delete to complete | 
74.7. stack environment show
Show a stack’s environment.
Usage:
| Value | Summary | 
|---|---|
| <NAME or ID> | Name or id of stack to query | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.8. stack event list
List events.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to show events for | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --resource <resource> | Name of resource to show events for. note: this cannot be specified with --nested-depth | 
| --filter <key=value> | Filter parameters to apply on returned events | 
| --limit <limit> | Limit the number of events returned | 
| --marker <id> | Only return events that appear after the given id | 
| --nested-depth <depth> | Depth of nested stacks from which to display events. Note: this cannot be specified with --resource | 
| --sort <key>[:<direction>] | Sort output by selected keys and directions (asc or desc) (default: asc). Specify multiple times to sort on multiple keys. Sort key can be: "event_time" (default), "resource_name", "links", "logical_resource_id", "resource_status", "resource_status_reason", "physical_resource_id", or "id". You can leave the key empty and specify ":desc" for sorting by reverse time. | 
| --follow | Print events until process is halted | 
| Value | Summary | 
|---|---|
| -f {csv,json,log,table,value,yaml}, --format {csv,json,log,table,value,yaml} | The output format, defaults to log | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.9. stack event show
Show event details.
Usage:
openstack stack event show [-h] [-f {json,shell,table,value,yaml}]
                                  [-c COLUMN] [--noindent] [--prefix PREFIX]
                                  [--max-width <integer>] [--fit-width]
                                  [--print-empty]
                                  <stack> <resource> <event>
openstack stack event show [-h] [-f {json,shell,table,value,yaml}]
                                  [-c COLUMN] [--noindent] [--prefix PREFIX]
                                  [--max-width <integer>] [--fit-width]
                                  [--print-empty]
                                  <stack> <resource> <event>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to show events for | 
| <resource> | Name of the resource event belongs to | 
| <event> | Id of event to display details for | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.10. stack export
Export stack data json.
Usage:
openstack stack export [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] [--output-file <output-file>]
                              <stack>
openstack stack export [-h] [-f {json,shell,table,value,yaml}]
                              [-c COLUMN] [--noindent] [--prefix PREFIX]
                              [--max-width <integer>] [--fit-width]
                              [--print-empty] [--output-file <output-file>]
                              <stack>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to export | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --output-file <output-file> | File to output export data | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to json | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.11. stack failures list
Show information about failed stack resources.
Usage:
openstack stack failures list [-h] [--long] <stack>
openstack stack failures list [-h] [--long] <stack>| Value | Summary | 
|---|---|
| <stack> | Stack to display (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --long | Show full deployment logs in output | 
74.12. stack file list
Show a stack’s files map.
Usage:
openstack stack file list [-h] [-f {json,shell,table,value,yaml}]
                                 [-c COLUMN] [--noindent] [--prefix PREFIX]
                                 [--max-width <integer>] [--fit-width]
                                 [--print-empty]
                                 <NAME or ID>
openstack stack file list [-h] [-f {json,shell,table,value,yaml}]
                                 [-c COLUMN] [--noindent] [--prefix PREFIX]
                                 [--max-width <integer>] [--fit-width]
                                 [--print-empty]
                                 <NAME or ID>| Value | Summary | 
|---|---|
| <NAME or ID> | Name or id of stack to query | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.13. stack hook clear
Clear resource hooks on a given stack.
Usage:
openstack stack hook clear [-h] [--pre-create] [--pre-update]
                                  [--pre-delete]
                                  <stack> <resource> [<resource> ...]
openstack stack hook clear [-h] [--pre-create] [--pre-update]
                                  [--pre-delete]
                                  <stack> <resource> [<resource> ...]| Value | Summary | 
|---|---|
| <stack> | Stack to display (name or id) | 
| <resource> | Resource names with hooks to clear. resources in nested stacks can be set using slash as a separator: ``nested_stack/another/my_resource``. You can use wildcards to match multiple stacks or resources: ``nested_stack/an*/*_resource`` | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --pre-create | Clear the pre-create hooks | 
| --pre-update | Clear the pre-update hooks | 
| --pre-delete | Clear the pre-delete hooks | 
74.14. stack hook poll
List resources with pending hook for a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack to display (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --nested-depth <nested-depth> | Depth of nested stacks from which to display hooks | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.15. stack list
List stacks.
Usage:
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --deleted | Include soft-deleted stacks in the stack listing | 
| --nested | Include nested stacks in the stack listing | 
| --hidden | Include hidden stacks in the stack listing | 
| --property <key=value> | Filter properties to apply on returned stacks (repeat to filter on multiple properties) | 
| --tags <tag1,tag2…> | List of tags to filter by. can be combined with --tag- mode to specify how to filter tags | 
| --tag-mode <mode> | Method of filtering tags. must be one of "any", "not", or "not-any". If not specified, multiple tags will be combined with the boolean AND expression | 
| --limit <limit> | The number of stacks returned | 
| --marker <id> | Only return stacks that appear after the given id | 
| --sort <key>[:<direction>] | Sort output by selected keys and directions (asc or desc) (default: asc). Specify multiple times to sort on multiple properties | 
| --all-projects | Include all projects (admin only) | 
| --short | List fewer fields in output | 
| --long | List additional fields in output, this is implied by --all-projects | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.16. stack output list
List stack outputs.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to query | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.17. stack output show
Show stack output.
Usage:
openstack stack output show [-h] [-f {json,shell,table,value,yaml}]
                                   [-c COLUMN] [--noindent] [--prefix PREFIX]
                                   [--max-width <integer>] [--fit-width]
                                   [--print-empty] [--all]
                                   <stack> [<output>]
openstack stack output show [-h] [-f {json,shell,table,value,yaml}]
                                   [-c COLUMN] [--noindent] [--prefix PREFIX]
                                   [--max-width <integer>] [--fit-width]
                                   [--print-empty] [--all]
                                   <stack> [<output>]| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to query | 
| <output> | Name of an output to display | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --all | Display all stack outputs | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.18. stack resource list
List stack resources.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to query | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --long | Enable detailed information presented for each resource in resource list | 
| -n <nested-depth>, --nested-depth <nested-depth> | Depth of nested stacks from which to display resources | 
| --filter <key=value> | Filter parameters to apply on returned resources based on their name, status, type, action, id and physical_resource_id | 
| Value | Summary | 
|---|---|
| -f {csv,dot,json,table,value,yaml}, --format {csv,dot,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.19. stack resource mark unhealthy
Set resource’s health.
Usage:
openstack stack resource mark unhealthy [-h] [--reset]
                                               <stack> <resource> [reason]
openstack stack resource mark unhealthy [-h] [--reset]
                                               <stack> <resource> [reason]| Value | Summary | 
|---|---|
| <stack> | Name or id of stack the resource belongs to | 
| <resource> | Name of the resource | 
| reason | Reason for state change | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --reset | Set the resource as healthy | 
74.20. stack resource metadata
Show resource metadata
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack to display (name or id) | 
| <resource> | Name of the resource to show the metadata for | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to json | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.21. stack resource show
Display stack resource.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to query | 
| <resource> | Name of resource | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --with-attr <attribute> | Attribute to show, can be specified multiple times | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.22. stack resource signal
Signal a resource with optional data.
Usage:
openstack stack resource signal [-h] [--data <data>]
                                       [--data-file <data-file>]
                                       <stack> <resource>
openstack stack resource signal [-h] [--data <data>]
                                       [--data-file <data-file>]
                                       <stack> <resource>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack the resource belongs to | 
| <resource> | Name of the resoure to signal | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --data <data> | Json data to send to the signal handler | 
| --data-file <data-file> | File containing json data to send to the signal handler | 
74.23. stack resume
Resume a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack(s) to resume (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --wait | Wait for resume to complete | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.24. stack show
Show stack details.
Usage:
openstack stack show [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--noindent] [--prefix PREFIX]
                            [--max-width <integer>] [--fit-width]
                            [--print-empty] [--no-resolve-outputs]
                            <stack>
openstack stack show [-h] [-f {json,shell,table,value,yaml}]
                            [-c COLUMN] [--noindent] [--prefix PREFIX]
                            [--max-width <integer>] [--fit-width]
                            [--print-empty] [--no-resolve-outputs]
                            <stack>| Value | Summary | 
|---|---|
| <stack> | Stack to display (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --no-resolve-outputs | Do not resolve outputs of the stack. | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.25. stack snapshot create
Create stack snapshot.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --name <name> | Name of snapshot | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.26. stack snapshot delete
Delete stack snapshot.
Usage:
openstack stack snapshot delete [-h] [-y] <stack> <snapshot>
openstack stack snapshot delete [-h] [-y] <stack> <snapshot>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack | 
| <snapshot> | Id of stack snapshot | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| -y, --yes | Skip yes/no prompt (assume yes) | 
74.27. stack snapshot list
List stack snapshots.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack containing the snapshots | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.28. stack snapshot restore
Restore stack snapshot
Usage:
openstack stack snapshot restore [-h] <stack> <snapshot>
openstack stack snapshot restore [-h] <stack> <snapshot>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack containing the snapshot | 
| <snapshot> | Id of the snapshot to restore | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
74.29. stack snapshot show
Show stack snapshot.
Usage:
openstack stack snapshot show [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     <stack> <snapshot>
openstack stack snapshot show [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     <stack> <snapshot>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack containing the snapshot | 
| <snapshot> | Id of the snapshot to show | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.30. stack suspend
Suspend a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Stack(s) to suspend (name or id) | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| --wait | Wait for suspend to complete | 
| Value | Summary | 
|---|---|
| -f {csv,json,table,value,yaml}, --format {csv,json,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| --sort-column SORT_COLUMN | Specify the column(s) to sort the data (columns specified first have a priority, non-existing columns are ignored), can be repeated | 
| Value | Summary | 
|---|---|
| --quote {all,minimal,none,nonnumeric} | When to include quotes, defaults to nonnumeric | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.31. stack template show
Display stack template.
Usage:
openstack stack template show [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     <stack>
openstack stack template show [-h] [-f {json,shell,table,value,yaml}]
                                     [-c COLUMN] [--noindent]
                                     [--prefix PREFIX] [--max-width <integer>]
                                     [--fit-width] [--print-empty]
                                     <stack>| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to query | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to yaml | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. | 
74.32. stack update
Update a stack.
Usage:
| Value | Summary | 
|---|---|
| <stack> | Name or id of stack to update | 
| Value | Summary | 
|---|---|
| -h, --help | Show this help message and exit | 
| -t <template>, --template <template> | Path to the template | 
| -e <environment>, --environment <environment> | Path to the environment. can be specified multiple times | 
| --pre-update <resource> | Name of a resource to set a pre-update hook to. Resources in nested stacks can be set using slash as a separator: ``nested_stack/another/my_resource``. You can use wildcards to match multiple stacks or resources: ``nested_stack/an*/*_resource``. This can be specified multiple times | 
| --timeout <timeout> | Stack update timeout in minutes | 
| --rollback <value> | Set rollback on update failure. value "enabled" sets rollback to enabled. Value "disabled" sets rollback to disabled. Value "keep" uses the value of existing stack to be updated (default) | 
| --dry-run | Do not actually perform the stack update, but show what would be changed | 
| --show-nested | Show nested stacks when performing --dry-run | 
| --parameter <key=value> | Parameter values used to create the stack. this can be specified multiple times | 
| --parameter-file <key=file> | Parameter values from file used to create the stack. This can be specified multiple times. Parameter value would be the content of the file | 
| --existing | Re-use the template, parameters and environment of the current stack. If the template argument is omitted then the existing template is used. If no --environment is specified then the existing environment is used. Parameters specified in --parameter will patch over the existing values in the current stack. Parameters omitted will keep the existing values | 
| --clear-parameter <parameter> | Remove the parameters from the set of parameters of current stack for the stack-update. The default value in the template will be used. This can be specified multiple times | 
| --tags <tag1,tag2…> | An updated list of tags to associate with the stack | 
| --wait | Wait until stack goes to update_complete or UPDATE_FAILED | 
| --converge | Stack update with observe on reality. | 
| Value | Summary | 
|---|---|
| -f {json,shell,table,value,yaml}, --format {json,shell,table,value,yaml} | The output format, defaults to table | 
| -c COLUMN, --column COLUMN | Specify the column(s) to include, can be repeated | 
| Value | Summary | 
|---|---|
| --noindent | Whether to disable indenting the json | 
| Value | Summary | 
|---|---|
| --prefix PREFIX | Add a prefix to all variable names | 
| Value | Summary | 
|---|---|
| --max-width <integer> | Maximum display width, <1 to disable. you can also use the CLIFF_MAX_TERM_WIDTH environment variable, but the parameter takes precedence. | 
| --fit-width | Fit the table to the display width. implied if --max- width greater than 0. Set the environment variable CLIFF_FIT_WIDTH=1 to always enable | 
| --print-empty | Print empty table if there is no data to show. |