Skip to main content
A newer release of this product is available.

vserver nvme namespace show

Contributors
Suggest changes
PDFs

Display NVMe namespaces

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver nvme namespace show command displays information for NVMe namespaces.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver Name

Use this parameter to display the NVMe namespaces that match the Vserver that you specify.

[-path <path>] - Namespace Path

Use this parameter to display the NVMe namespace that matches the path that you specify.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Size

Use this parameter to display the NVMe namespaces that match the size that you specify.

[-size-used {<integer>[KB|MB|GB|TB|PB]}] - Size Used

Use this parameter to display the NVMe namespaces that match this parameter value.

[-ostype {vmware|hyper_v|windows|linux|xen}] - OS Type

Use this parameter to display the NVMe namespaces that match this parameter value.

[-comment <text>] - Comment

Use this parameter to display the NVMe namespaces that match this parameter value.

[-block-size {512|4KB}] - Block Size

Use this parameter to display the NVMe namespaces that match this parameter value.

[-state {online|offline|nvfail|space-error}] - State

Use this parameter to display the NVMe namespaces that match this parameter value.

[-is-read-only {true|false}] - Is Read Only

Use this parameter to display the NVMe namespaces that match this parameter value.

[-creation-timestamp <MM/DD/YYYY HH:MM:SS>] - Creation Time

Use this parameter to display the NVMe namespaces that match this parameter value.

[-uuid <UUID>] - Namespace UUID

Use this parameter to display the NVMe namespaces that match this parameter value.

[-restore-inaccessible {true|false}] - Restore Inaccessible

Use this parameter to display the NVMe namespaces that match this parameter value.

[-node <nodename>] - Node Hosting the Namespace

Use this parameter to display the NVMe namespaces that match this parameter value.

[-volume <volume name>] - Volume Name

Use this parameter to display the NVMe namespaces that match this parameter value.

[-qtree <qtree name>] - Qtree Name

Use this parameter to display the NVMe namespaces that match this parameter value.

[-subsystem <text>] - Mapped Subsystem

Use this parameter to display the NVMe namespaces that are attached to a Subsystem that matches this parameter value.

[-nsid <Hex 32bit Integer>] - Namespace ID

Use this parameter to display the NVMe namespaces that match this parameter value.

[-anagrpid <Hex 32bit Integer>] - ANA Group ID (privilege: advanced)

Use this parameter to display the NVMe namespaces that match Asymmetric Namespace Access (ANA) group identifier that you specify.

[-vserver-id <integer>] - Vserver ID

Use this parameter to display the NVMe namespaces that match this parameter value.

[-container-state {online|aggregate-offline|volume-offline|error}] - Namespace Container State (privilege: advanced)

Selects the namespaces that match this parameter value. The container states are:

  • online - The namespace's aggregate and volume are online.

  • aggregate-offline - The namespace's aggregate is offline.

  • volume-offline - The namespace's volume is offline.

  • error - An error occurred accessing the namespace's volume.

[-include-offline-containers <true>] - Include Namespaces on Offline Volumes and Aggregates (privilege: advanced)

If true, include available information for namespaces in offline aggregates and offline volumes in the output. By default, namespaces in offline aggregates and offline volumes are excluded from the output.

Examples

cluster::*> vserver nvme namespace show -vserver vs1
Vserver   Path                            State     Size Subsystem       NSID
--------- ------------------------------- ------- ------ ---------- ---------
vs1       /vol/test_1_vol/ns1             online    10GB subsys1    00000001h
vs1       /vol/test_1_vol/ns2             online   500MB subsys1    00000002h
vs1       /vol/test_1_vol/ns3             online     1TB -                  -
3 entries were displayed.