storage pool show-available-capacity

Display available capacity of storage pools

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

Description

The storage pool show-available-capacity command displays information about available capacity in SSD storage pools on each node in the cluster. The command output depends upon the parameter or parameters specified with the command. If no parameters are specified, the command displays information about available capacities in all shared pools in the cluster.

Storage pool available capacity is data storage space that has not yet been provisioned into Flash Pool or All-Flash aggregates. Allocation units might be provisioned into aggregates using the storage aggregate add-disks command and the -storage-pool parameter.

Note: All storage pool available capacity can be provisioned into aggregates. Available capacity within a storage pool is not used to protect against a disk failure. In the case of an SSD failure or predicted failure, Data ONTAP moves a suitable whole SSD spare disk from outside the storage pool into the storage pool and begins the recovery process (using either reconstruction or Rapid RAID Recovery, whichever is appropriate).

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.
[-storage-pool <storage pool name>] - Name of Storage Pool
Selects the available capacities that match this parameter value.
[-node {<nodename>|local}] - Node
Selects the available capacities that match this parameter value.
[-allocation-unit-size {<integer>[KB|MB|GB|TB|PB]}] - Allocation Unit Size
Selects the available capacities that match this parameter value.

Allocation units are the units of storage capacity that are available to be provisioned into aggregates.

[-storage-type <SSD>] - Type of Storage Pool
Selects the available capacities that match this parameter value. Only the SSD type is supported for this version of Data ONTAP.
[-allocation-unit-count <integer>] - Number of Allocation Units Available
Selects the available capacities that match this parameter value.

Allocation units are the units of storage capacity that are available to be provisioned into aggregates. Each allocation unit is one minimum unit of allocation (MUA) and its capacity is given as allocation-unit-size.

[-syncmirror-pool <text>] - Syncmirror Pool
Selects the available capacities that match this parameter value.

The SyncMirror pool of an allocation unit must match the SyncMirror pool of the disks of the aggregate when adding allocation units into an aggregate.

Mirroring of aggregates that are provisioned from SSD storage pools is not supported.

[-available-size {<integer>[KB|MB|GB|TB|PB]}] - Total Usable Available Size
Selects the available capacities that match this parameter value.

The available-size is the sum of the capacities of the allocation units that are assigned but not yet provisioned. The amount of available-size that is contributed to the cache or usable capacity of an aggregate depends upon the RAID type used when provisioning the allocation units.

Examples

In this example, two nodes of an HA pair share available capacity from two storage pools, SP1 and SP2. There are a total of 5 allocation units that have not yet been provisioned.
cluster1::> storage pool show-available-capacity
                           Storage SyncMirror Allocation Unit  Total
Node       Storage Pool    Type    Pool       Unit size  Count Usable Size
---------- --------------- ------- ---------- ---------- ----- -----------
node-a     SP1             SSD     Pool0         558.7GB     1     558.7GB
node-b     SP1             SSD     Pool0         558.7GB     1     558.7GB
node-a     SP2             SSD     Pool0         744.9GB     2      1.45TB
node-b     SP2             SSD     Pool0         744.9GB     1     744.9GB