Here is a cheat sheet listing key Pure Storage CLI commands along with descriptions and examples:
PureStorage General Commands
| Command | Description |
|---|---|
pureversion | Displays the Purity OS version. |
pureconfig list | Generates a script to recreate the array config. |
PureStorage Array Management (purearray)
| Command | Description |
|---|---|
purearray list | Displays array details like serial number and version. |
purearray list --space | Shows capacity usage details. |
purearray list --ntpserver | Displays configured NTP servers for time sync. |
purearray connect --target <array> | Connects the array to another Pure array. |
PureStorage Volume Management (purevol)
| Command | Description |
|---|---|
purevol list | Lists all volumes on the array. |
purevol create <name> --size <size> | Creates a new volume with the specified size. |
purevol delete <name> | Deletes a volume. |
purevol connect <vol> --host <host> | Connects a volume to a host. |
purevol disconnect <vol> --host <host> | Disconnects a volume from a host. |
PureStorage Host Management (purehost)
| Command | Description |
|---|---|
purehost list | Lists all hosts. |
purehost create <host> | Creates a new host. |
purehost delete <host> | Deletes a host. |
purehost addwwn <host> --wwn <wwn> | Adds a WWN to a host. |
purehost connect <host> --vol <vol> | Connects a host to a volume. |
PureStorage Host Group Management (purehgroup)
| Command | Description |
|---|---|
purehgroup list | Lists all host groups. |
purehgroup create <hgroup> | Creates a new host group. |
purehgroup delete <hgroup> | Deletes a host group. |
purehgroup connect <hgroup> --vol <vol> | Connects a host group to a volume. |
PureStorage Drive Management (puredrive)
| Command | Description |
|---|---|
puredrive list | Lists all drives in the array. |
puredrive admit | Admits unadmitted drives into the array. |
puredrive list --bay <bay> | Displays drive details for a specific bay. |
PureStorage Hardware Management (purehw)
| Command | Description |
|---|---|
purehw list | Lists all hardware components. |
purehw list --spec | Shows detailed specifications of hardware. |
purehw list --type <type> | Lists specific hardware types like drives or fans. |
PureStorage Port Management (pureport)
| Command | Description |
|---|---|
pureport list | Lists all array target ports. |
pureport list --initiator | Lists all host initiators. |
PureStorage Snapshot Management (purevol for snapshots)
| Command | Description |
|---|---|
purevol snap <name> | Creates a snapshot of the specified volume. |
purevol list --snap | Lists all snapshots. |
purevol eradicate <name>.snap | Permanently deletes a snapshot. |
PureStorage Alert Management (purealert)
| Command | Description |
|---|---|
purealert list | Lists all alerts. |
purealert delete <alert_id> | Deletes a specific alert. |
Notes:
- Replace placeholders like
<name>,<size>,<host>,<vol>with actual values. - Always validate commands in your environment as some may require specific permissions or configurations.
PureStorage Commands with output
PureStorage General Commands
Command: pureversion
Description: Displays the Purity OS version installed on the array.
Output:
Product: FlashArray
Model: FA-X20
Version: Purity//FA 6.2.0
Command: pureconfig list
Description: Generates a script to recreate the array configuration.
Output:
purevol create my_volume --size 1T
purehost create app_server
purevol connect my_volume --host app_server
purearray set --ntpserver ntp.example.com
PureStorage Array Management
Command: purearray list
Description: Displays array details like name, serial number, and firmware version.
Output:
Name Model Serial Version Uptime
-----------------------------------------------------------
Flash1 FlashArray FA-12345 Purity//FA 6.2 120 days
Command: purearray list --space
Description: Shows capacity usage details of the array.
Output:
Total Used Free Data Reduction
---------------------------------------------
50TB 20TB 30TB 3.0:1
PureStorage Volume Management
Command: purevol list
Description: Lists all volumes on the array.
Output:
Name Size Source Connected Hosts
------------------------------------------------
my_volume 1TB - 2
data_vol 500GB - 1
Command: purevol snap my_volume
Description: Creates a snapshot of the specified volume.
Output:
Snapshot my_volume.snap1 created.
Command: purevol list --snap
Description: Lists all snapshots.
Output:
Name Size Parent Volume
----------------------------------------
my_volume.snap1 1TB my_volume
data_vol.snap1 500GB data_vol
PureStorage Host Management
Command: purehost list
Description: Lists all hosts connected to the array.
Output:
Name IQN/WNN Volumes Connected
--------------------------------------------------------------
app_server iqn.1991-05.com.example:app1 1
db_server iqn.1991-05.com.example:db1 2
Command: purehost create app_server
Description: Creates a new host.
Output:
Host app_server created.
Command: purehost addwwn app_server --wwn 21000024FF649B3B
Description: Adds a WWN to the specified host.
Output:
WWN 21000024FF649B3B added to host app_server.
PureStorage Drive Management
Command: puredrive list
Description: Lists all drives in the array.
Output:
Bay Type Capacity Status
------------------------------
1 NVMe 3.84TB Healthy
2 NVMe 3.84TB Healthy
3 NVMe 3.84TB Healthy
Command: puredrive admit
Description: Admits unadmitted drives into the array.
Output:
Drive in Bay 4 admitted.
PureStorage Hardware Management
Command: purehw list
Description: Lists all hardware components.
Output:
Component Status Model Serial
-----------------------------------------------
Controller 0 OK FA-X20 CT0SN12345
Controller 1 OK FA-X20 CT1SN12345
Drive Bay 1 OK NVMe BAY1SN123
Command: purehw list --spec
Description: Displays detailed hardware specifications.
Output:
Model: FlashArray-X20
Firmware: Purity//FA 6.2.0
Part Number: FA-X20-12345
Serial: FA-12345
PureStorage Alert Management
Command: purealert list
Description: Lists all alerts in the array.
Output:
ID Severity Message Time
--------------------------------------------------------------------
12345 Critical Volume disconnected unexpectedly 2025-01-17 12:00:00
67890 Warning Latency increased above threshold 2025-01-17 10:00:00
Command: purealert delete 12345
Description: Deletes a specific alert.
Output:
Alert ID 12345 deleted.