---
title: "view list"
slug: "view-list"
tags: ["5.5"]
updated: 2026-10-27T23:00:54Z
published: 2026-10-27T23:00:54Z
canonical: "docs.vastdata.com/view-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# view list

This command displays configured views.

## Usage

```plaintext
view list [--path PATH]
          [--alias ALIAS]
          [--policy-name VIEW_POLICY_NAME]
          [--policy-id VIEW_POLICY_ID]
          [--cluster-name CLUSTER_NAME]
          [--cluster-id CLUSTER_ID]
          [--tenant-name TENANT_NAME]
          [--tenant-id TENANT_ID]
          [--page PAGE]
          [--page-size PAGE-SIZE]
```

## Options

| `--name VIEW_NAME` | Filters views by view name. |
| --- | --- |
| `--path PATH` | Filters views by directory path. |
| `--alias ALIAS` | Filters views by NFS export alias. |
| `--policy-name VIEW_POLICY_NAME` | Filters views by view policy name. |
| `--policy-id VIEW_POLICY_ID` | Filters views by view policy ID. |
| `--cluster-name CLUSTER_NAME` | Filters views by cluster name. |
| `--cluster-id CLUSTER_ID` | Filters views by cluster ID. |
| `--tenant-name TENANT_NAME` | Filters views by tenant name. |
| `--tenant-id TENANT_ID` | Filters views by tenant ID. |
| `--page PAGE` | Displays a specified page of views, where page size is the maximum number of views to display per page. |
| `--page-size PAGE-SIZE` | Sets the number of views per page for displaying by page (using the `--page` option). Default: 20 Maximum: 500 |

## Examples

```plaintext
vcli: admin> view list --page-size 1 --page 1
+----+------+-------+-------+--------+--------------+---------+-----------------+------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+------+-------------------------------------------------------------------------+----------------------+
| ID | Path | Alias | Share | Bucket | Bucket-owner | Policy  | Protocols       | Cluster    | Physical-capacity | Logical-capacity | WORM  | Is-remote | Created time        | Live Monitoring | Qos-policy | Tenant-id | Bulk-permission-update-state | Bulk-permission-update-progress | Files-retention-mode | Abe-protocols | Abe-max-depth | Global Synchronization | ABAC tags | User-impersonation      | Is-default-subsystem | Name | Nqn                                                                     | Smb-encryption-state |
+----+------+-------+-------+--------+--------------+---------+-----------------+------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+------+-------------------------------------------------------------------------+----------------------+
| 1  | /    | /     |       |        | None         | default | ['NFS', 'NFS4'] | vast88-kfs | 26493326598       | 245145279797     | False | False     | 2026-02-01 12:32:16 | False           | None       | 1         | None                         | None                            | NONE                 | []            | None          | False                  | []        | {'enabled': False,      | False                | root | nqn.2024-08.com.vastdata:cfc2ab3b-efdf-53c6-8270-c17386f7e294:default:/ | AVAILABLE            |
|    |      |       |       |        |              |         |                 |            |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier': '',      |                      |      |                                                                         |                      |
|    |      |       |       |        |              |         |                 |            |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier_type': '', |                      |      |                                                                         |                      |
|    |      |       |       |        |              |         |                 |            |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'login_name': '',      |                      |      |                                                                         |                      |
|    |      |       |       |        |              |         |                 |            |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'username': ''}        |                      |      |                                                                         |                      |
+----+------+-------+-------+--------+--------------+---------+-----------------+------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+------+-------------------------------------------------------------------------+----------------------+
```