13.28. manila list


usage: manila list [--all-tenants [<0|1>]] [--name <name>] [--status <status>]
                   [--share-server-id <share_server_id>]
                   [--metadata [<key=value> [<key=value> ...]]]
                   [--extra-specs [<key=value> [<key=value> ...]]]
                   [--share-type <share_type>] [--limit <limit>]
                   [--offset <offset>] [--sort-key <sort_key>]
                   [--sort-dir <sort_dir>] [--snapshot <snapshot>]
                   [--host <host>] [--share-network <share_network>]
                   [--project-id <project_id>] [--public]
                   [--consistency-group <consistency_group>]
                   [--columns <columns>]
Copy to Clipboard Toggle word wrap
List NAS shares with filters.

Optional arguments

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


      Display information from all tenants (Admin only).

--name <name>


        Filter results by name.

--status <status>


        Filter results by status.

--share-server-id <share_server_id>, --share-server_id <share_server_id>, --share_server-id <share_server_id>, --share_server_id <share_server_id>


      Filter results by share server ID (Admin only).

--metadata [<key=value> [<key=value> ...]]


      Filters results by a metadata key and value. OPTIONAL:
      Default=None

--extra-specs [<key=value> [<key=value> ...]], --extra_specs [<key=value> [<key=value> ...]]


      Filters results by a extra specs key and value of
      share type that was used for share creation. OPTIONAL:
      Default=None

--share-type <share_type>, --volume-type <share_type>, --share_type <share_type>, --share-type-id <share_type>, --volume-type-id <share_type>, --share-type_id <share_type>, --share_type-id <share_type>, --share_type_id <share_type>, --volume_type <share_type>, --volume_type_id <share_type>


      Filter results by a share type id or name that was
      used for share creation.

--limit <limit>


        Maximum number of shares to return. OPTIONAL:
      Default=None.

--offset <offset>


        Set offset to define start point of share listing.
      OPTIONAL: Default=None.

--sort-key <sort_key>, --sort_key <sort_key>


      Key to be sorted, available keys are ('id', 'status',
      'size', 'host', 'share_proto', 'export_location',
      'availability_zone', 'user_id', 'project_id',
      'created_at', 'updated_at', 'display_name', 'name',
      'share_type_id', 'share_type', 'share_network_id',
      'share_network', 'snapshot_id', 'snapshot'). OPTIONAL:
      Default=None.

--sort-dir <sort_dir>, --sort_dir <sort_dir>


      Sort direction, available values are ('asc', 'desc').
      OPTIONAL: Default=None.

--snapshot <snapshot>


      Filer results by snapshot name or id, that was used
      for share.

--host <host>


        Filter results by host.

--share-network <share_network>, --share_network <share_network>


      Filter results by share-network name or id.

--project-id <project_id>, --project_id <project_id>


      Filter results by project id. Useful with set key
      '--all-tenants'.

--public


        Add public shares from all tenants to result.

--consistency-group <consistency_group>, --consistency_group <consistency_group>, --cg <consistency_group>


      Filter results by consistency group name or ID
      (Experimental, Default=None).

--columns <columns>


        Comma separated list of columns to be displayed e.g.
      --columns "export_location,is public"

Back to top
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

© 2025 Red Hat