Red Hat Training

A Red Hat training course is available for Red Hat OpenStack Platform

5.99. nova list

usage: nova list [--reservation-id <reservation-id>] [--ip <ip-regexp>]
                 [--ip6 <ip6-regexp>] [--name <name-regexp>]
                 [--instance-name <name-regexp>] [--status <status>]
                 [--flavor <flavor>] [--image <image>] [--host <hostname>]
                 [--all-tenants [<0|1>]] [--tenant [<tenant>]]
                 [--user [<user>]] [--deleted] [--fields <fields>] [--minimal]
                 [--sort <key>[:<direction>]] [--marker <marker>]
                 [--limit <limit>] [--changes-since <changes_since>]
                 [--tags <tags>] [--tags-any <tags-any>]
                 [--not-tags <not-tags>] [--not-tags-any <not-tags-any>]
List active servers.

Optional arguments

--reservation-id <reservation-id>


      Only return servers that match reservation-id.

--ip <ip-regexp>


        Search with regular expression match by IP
      address.

--ip6 <ip6-regexp>


        Search with regular expression match by IPv6
      address.

--name <name-regexp>


        Search with regular expression match by name.

--instance-name <name-regexp>


      Search with regular expression match by server
      name.

--status <status>


        Search by server status.

--flavor <flavor>


        Search by flavor name or ID.

--image <image>


        Search by image name or ID.

--host <hostname>


        Search servers by hostname to which they are
      assigned (Admin only).

--all-tenants [<0|1>]


        Display information from all tenants (Admin
      only).

--tenant [<tenant>]


        Display information from single tenant (Admin
      only).

--user [<user>]


        Display information from single user (Admin
      only).

--deleted


        Only display deleted servers (Admin only).

--fields <fields>


        Comma-separated list of fields to display. Use
      the show command to see which fields are
      available.

--minimal


        Get only UUID and name.

--sort <key>[:<direction>]


        Comma-separated list of sort keys and
      directions in the form of <key>[:<asc|desc>].
      The direction defaults to descending if not
      specified.

--marker <marker>


        The last server UUID of the previous page;
      displays list of servers after "marker".

--limit <limit>


        Maximum number of servers to display. If limit
      == -1, all servers will be displayed. If limit
      is bigger than 'osapi_max_limit' option of
      Nova API, limit 'osapi_max_limit' will be used
      instead.

--changes-since <changes_since>


      List only servers changed after a certain
      point of time.The provided time should be an
      ISO 8061 formatted time.ex
      2016-03-04T06:27:59Z .

--tags <tags>


        The given tags must all be present for a
      server to be included in the list result.
      Boolean expression in this case is 't1 AND
      t2'. Tags must be separated by commas: --tags
      <tag1,tag2> (Supported by API versions '2.26'
      - '2.latest')

--tags-any <tags-any>


        If one of the given tags is present the server
      will be included in the list result. Boolean
      expression in this case is 't1 OR t2'. Tags
      must be separated by commas: --tags-any
      <tag1,tag2> (Supported by API versions '2.26'
      - '2.latest')

--not-tags <not-tags>


        Only the servers that do not have any of the
      given tags willbe included in the list
      results. Boolean expression in this case is
      'NOT(t1 AND t2)'. Tags must be separated by
      commas: --not-tags <tag1,tag2> (Supported by
      API versions '2.26' - '2.latest')

--not-tags-any <not-tags-any>


      Only the servers that do not have at least one
      of the given tagswill be included in the list
      result. Boolean expression in this case is
      'NOT(t1 OR t2)'. Tags must be separated by
      commas: --not-tags-any <tag1,tag2> (Supported
      by API versions '2.26' - '2.latest')