This command displays details of a view.
Usage
view show --id ID [--global-synchronization] [--s3] [--share-level-acl] [--worm] [--kafka]
Required Parameters
| Specify the ID of the view you want to view. |
Options
| If the view supports global synchronization, this option displays details of synchronization between the view and other views that support global synchronization. When a view supports global synchronization, the cluster checks for views on paths protected by the same replication group as the view path and synchronizes file handles with those views. The command output shows you if there is a matching view on each remote peer that has global synchronization enabled, and whether it is synced with this view. The global synchronization feature enables views to support seamless replication failover. |
| Displays S3 details. |
| Displays share-level ACL details. |
| Displays WORM details for the View. |
| Displays Kafka protocol settings in effect for the view. |
Example
vcli: admin> view show --id 3
+---------------------------------+---------------------------------------------------------------------------------------------------+
| ID | 3 |
| Path | /blockstorage |
| Alias | blocktarget1 |
| Share | |
| Bucket | |
| Bucket-owner | None |
| Policy | default |
| Protocols | ['BLOCK'] |
| Cluster | docs-system1-gcp |
| Physical-capacity | 0 |
| Logical-capacity | 0 |
| WORM | False |
| Is-remote | False |
| Created time | 2025-02-26 13:01:36 |
| Live Monitoring | False |
| Qos-policy | None |
| Tenant-id | 1 |
| Bulk-permission-update-state | None |
| Bulk-permission-update-progress | None |
| Files-retention-mode | NONE |
| Abe-protocols | [] |
| Abe-max-depth | None |
| Global Synchronization | False |
| ABAC tags | [] |
| User-impersonation | {'enabled': False, 'identifier': '', 'identifier_type': '', 'login_name': '', 'username': ''} |
| Is-default-subsystem | False |
| Name | blocktarget1 |
| Nqn | nqn.2024-08.com.vastdata:c4d2b679-17c4-5075-b8c2-079410246670:default:blocktarget1 |
| Smb-encryption-state | |
+---------------------------------+---------------------------------------------------------------------------------------------------+
This example displays S3 details of a view:
vcli: admin> view show --id 26 --s3 +---------------------------+-------------------------+ | Path | /bucket-jovial-lyrebird | | Bucket | bucket-jovial-lyrebird | | Bucket-owner | lean-cerberus | | S3-versioning | False | | Allow-s3-anonymous-access | False | | Bucket Creators (Users) | [] | | Bucket Creators (Groups) | [] | | S3-unverified-lookup | False | +---------------------------+-------------------------+
This example shows share-level ACL details for a view.
vcli: admin> view show --id 5 --share-level-acl Share-level ACL is disabled Share-level ACL is not configured
This example shows information about global synchronization for a view that has global synchronization enabled. In this case, there is a view on a remote replicated path on a remote peer but the view does not have global synchronization enabled. In order to complete the configuration of global synchronization for the replication path, a new view must be created on the remote peer with global synchronization enabled.
vcli: admin> view show --id 13 --global-synchronization +----------+--------------+-----------+-------------+-----------------------------------------------------+ | Path | Cluster name | Peer name | Sync status | Failure-reason | +----------+--------------+-----------+-------------+-----------------------------------------------------+ | /rep_dir | ClusterA | peerAtoB | Error | Remote view does not support global synchronization | +----------+--------------+-----------+-------------+-----------------------------------------------------+
This example shows WORM details for a view.
vcli: admin> view show --id 9 --worm +--------------------------+------------------------------------+ | Path | /inventive-cockatoo-fee5-view-622d | | WORM | True | | Files-retention-mode | N/A | | Default-retention-period | | | Min-retention-period | N/A | | Max-retention-period | N/A | | Auto-commit | N/A | +--------------------------+------------------------------------+
The following example shows Kafka protocol settings for a view:
vcli: admin> view show --id 173 --kafka +----------------------------------+-----------------------------------------+ | ID | 173 | | Name | S3-38451909-023a-4238-b78d-1ae37dc0aa37 | | Path | /bucket-97tv19r84pytuqmkla2kmww8 | | Kafka VIP Pools | [] | | Kafka Rejoin Group Timeout | 60 | | Kafka First Join Group Timeout | 60 | | Allow unencrypted connection | True | | Kafka-unencrypted-auth-mechanism | NONE | | Allow encrypted connection | False | | Kafka-encrypted-auth-mechanism | NONE | | Authorization required | False | +----------------------------------+-----------------------------------------+