---
title: "view list"
slug: "view-list"
updated: 2026-10-27T17:24:49Z
published: 2026-10-27T17:24:49Z
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
+----+---------------+--------------+-------+--------+--------------+---------+-----------+------------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+--------------+------------------------------------------------------------------------------------+
| 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                                                                                |
+----+---------------+--------------+-------+--------+--------------+---------+-----------+------------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+--------------+------------------------------------------------------------------------------------+
| 1  | /             | /            |       |        | None         | default | ['NFS']   | docs-system1-gcp | 0                 | 0                | False | False     | 2025-02-26 11:24:35 | False           | None       | 1         | None                         | None                            | NONE                 | []            | None          | False                  | []        | {'enabled': False,      | False                | root         |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier': '',      |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier_type': '', |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'login_name': '',      |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'username': ''}        |                      |              |                                                                                    |
| 3  | /blockstorage | blocktarget1 |       |        | None         | default | ['BLOCK'] | docs-system1-gcp | 0                 | 0                | False | False     | 2025-02-26 13:01:36 | False           | None       | 1         | None                         | None                            | NONE                 | []            | None          | False                  | []        | {'enabled': False,      | False                | blocktarget1 | nqn.2024-08.com.vastdata:c4d2b679-17c4-5075-b8c2-079410246670:default:blocktarget1 |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier': '',      |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'identifier_type': '', |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'login_name': '',      |                      |              |                                                                                    |
|    |               |              |       |        |              |         |           |                  |                   |                  |       |           |                     |                 |            |           |                              |                                 |                      |               |               |                        |           |  'username': ''}        |                      |              |                                                                                    |
+----+---------------+--------------+-------+--------+--------------+---------+-----------+------------------+-------------------+------------------+-------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+------------------------+-----------+-------------------------+----------------------+--------------+------------------------------------------------------------------------------------+

vcli: admin> view list
+----+-----------+-------+-------+--------+--------------+---------+-----------------+-----------+-------------------+------------------+----------+-------------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+-----------------------------+-----------+
| ID | Path      | Alias | Share | Bucket | Bucket-owner | Policy  | Protocols       | Cluster   | Physical-capacity | Logical-capacity | S3-locks | NFS-interop | 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 |
+----+-----------+-------+-------+--------+--------------+---------+-----------------+-----------+-------------------+------------------+----------+-------------+-----------+---------------------+-----------------+------------+-----------+------------------------------+---------------------------------+----------------------+---------------+---------------+-----------------------------+-----------+
| 1  | /         | /     |       |        | None         | default | ['NFS', 'NFS4'] | mycluster | 666777066374      | 2027959133651    | False    | Disabled    | False     | 2023-05-12 05:07:57 | False           | None       | 1         | N/A                          | 0                               | NONE                 |[]             | None          |  False                      |[]         |
| 3  | /io_agent |       |       |        | None         | default | ['NFS']         | mycluster | 161732            | 293901970596     | False    | Disabled    | False     | 2023-05-12 05:11:22 | False           | None       | 1         | N/A                          | 0                               | NONE                 |[]             | None          |  False                      |           |
| 4  | /path1    |       |       |        | None         | default | ['NFS']         | mycluster | 23761665568       | 867598264582     | False    | Disabled    | False     | 2023-05-12 05:11:40 | False           | None       | 1         | N/A                          | 0                               | NONE                 |[]             | None          |  False                      |           |
| 5  | /path2    |       |       |        | None         | default | ['NFS']         | mycluster | 466004064         | 15724903967      | False    | Disabled    | False     | 2023-05-12 05:11:45 | False           | None       | 1         | N/A                          | 0                               | NONE                 |[]             | None          |  False                      |           |
+----+-----------+-------+-------+--------+--------------+---------+-----------------+-----------+-------------------+------------------+----------+-------------+-----------+---------------------+-----------------+------------+-----------+------------------------------|---------------------------------|---------------|---------------|-----------------------------+-----------+
```