10.41. heat stack-list


usage: heat stack-list [-s] [-n] [-a] [-f <KEY1=VALUE1;KEY2=VALUE2...>]
                       [-t <TAG1,TAG2...>] [--tags-any <TAG1,TAG2...>]
                       [--not-tags <TAG1,TAG2...>]
                       [--not-tags-any <TAG1,TAG2...>] [-l <LIMIT>] [-m <ID>]
                       [-k <KEY1;KEY2...>] [-d [asc|desc]] [-g] [-o]
List the user's stacks.

Optional arguments

-s, --show-deleted


        Include soft-deleted stacks in the stack listing.

-n, --show-nested


        Include nested stacks in the stack listing.

-a, --show-hidden


        Include hidden stacks in the stack listing.

-f <KEY1=VALUE1;KEY2=VALUE2...>, --filters <KEY1=VALUE1;KEY2=VALUE2...>


      Filter parameters to apply on returned stacks. This
      can be specified multiple times, or once with
      parameters separated by a semicolon.

-t <TAG1,TAG2...>, --tags <TAG1,TAG2...>


      Show stacks containing these tags, combine multiple
      tags using the boolean AND expression

--tags-any <TAG1,TAG2...>


      Show stacks containing these tags, combine multiple
      tags using the boolean OR expression

--not-tags <TAG1,TAG2...>


      Show stacks not containing these tags, combine
      multiple tags using the boolean AND expression

--not-tags-any <TAG1,TAG2...>


      Show stacks not containing these tags, combine
      multiple tags using the boolean OR expression

-l <LIMIT>, --limit <LIMIT>


      Limit the number of stacks returned.

-m <ID>, --marker <ID>


      Only return stacks that appear after the given stack
      ID.

-k <KEY1;KEY2...>, --sort-keys <KEY1;KEY2...>


      List of keys for sorting the returned stacks. This can
      be specified multiple times or once with keys
      separated by semicolons. Valid sorting keys include
      "stack_name", "stack_status", "creation_time" and
      "updated_time".

-d [asc|desc], --sort-dir [asc|desc]


      Sorting direction (either "asc" or "desc") for the
      sorting keys.

-g, --global-tenant


        Display stacks from all tenants. Operation only
      authorized for users who match the policy in heat's
      policy.json.

-o, --show-owner


        Display stack owner information. This is automatically
      enabled when using --global-tenant.

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red Hat
Back to top