kubectl directpv list drives

The kubectl directpv list drives command displays information about drives initialized and managed by DirectPV. Use this command to view drive status, capacity, volume counts, and custom labels.

For information on adding drives, see Managing Drives.

kubectl directpv list drives

┌─────────────────────────────────────────┬───────┬──────┬──────┬─────────┬─────────┬───────────┬─────────┬────────┐
│ DRIVE ID                                │ NODE  │ NAME │ MAKE │ SIZE    │ FREE    │ ALLOCATED │ VOLUMES │ STATUS │
├─────────────────────────────────────────┼───────┼──────┼──────┼─────────┼─────────┼───────────┼─────────┼────────┤
│ a1b2c3d4-e5f6-7890-abcd-ef1234567890    │ node1 │ sdb  │ -    │ 100 GiB │ 80 GiB  │ 20 GiB    │ 2       │ Ready  │
│ b2c3d4e5-f6a7-8901-bcde-f12345678901    │ node1 │ sdc  │ -    │ 100 GiB │ 100 GiB │ 0 B       │ -       │ Ready  │
│ c3d4e5f6-a7b8-9012-cdef-123456789012    │ node2 │ sdb  │ -    │ 100 GiB │ 50 GiB  │ 50 GiB    │ 5       │ Ready  │
└─────────────────────────────────────────┴───────┴──────┴──────┴─────────┴─────────┴───────────┴─────────┴────────┘

kubectl directpv list drives [DRIVE_ID ...]         \
                             [--all]                \
                             [-d|--drives "string"] \
                             [--labels "string"]    \
                             [-n|--nodes "string"]  \
                             [--status "string"]

The following aliases have the same function:

• kubectl directpv list drive
• kubectl directpv list dr

Optional

List all drives regardless of status. By default, only drives in ready status are shown.

Optional

Filter output by node names. Supports ellipsis expansion notation.

Short form: -n

Optional

Filter output by drive names. Supports ellipsis expansion notation.

Short form: -d

Optional

Filter output by drive status.

Valid values: error, lost, moving, ready, removed

Optional

Filter output by drive labels. Supports comma-separated key=value pairs.

Optional

Display custom labels as an additional column in the output.

Optional

Set the output format.

Valid values: json, yaml, wide

Short form: -o

Optional

Omit column headers from the output.

This command supports the following global flags:

Display all drives that are available for volume provisioning. This is the default behavior when no flags are specified:

kubectl directpv list drives

Include drives in all states, such as error, lost, or removed:

kubectl directpv list drives --all

Identify drives that have encountered filesystem or hardware issues and may need repair or replacement:

kubectl directpv list drives --status=error

Use ellipsis expansion to filter by multiple nodes and drive names. This example lists SATA drives sda through sdf on nodes node1 through node4:

kubectl directpv list drives --nodes=node{1...4} --drives=sd{a...f}

List only drives with a specific label. For information on setting labels, see kubectl directpv label drives:

kubectl directpv list drives --labels tier=hot

Show custom labels and additional drive details:

kubectl directpv list drives --show-labels --output wide

Output drive data in YAML or JSON format for scripting or backup purposes:

kubectl directpv list drives --output yaml

By default, the command only lists drives in ready status. Use --all to see drives in all statuses, or --status to filter by a specific status.

Additional status flags may appear:

• SchedulingDisabled - Drive is cordoned and will not receive new volumes
• Suspended - Drive is suspended for maintenance