Obtaining a list of information about storage pools

Virtual Storage Platform One SDS Block Storage Administrator Guide
Version
1.17.x
Audience
anonymous
Part Number
MK-24VSP1SDS002-04

The following information can be obtained.

  • id: IDs (uuid) of storage pools

  • name: Names of storage pools

  • protectionDomainId: IDs (uuid) of protection domains containing storage pools

  • statusSummary: Summary of statuses of storage pools

  • status: Status of each storage node

  • totalCapacity: Logical capacity of the storage pool [MiB]

  • totalRawCapacity: Valid physical capacity in the total physical capacity of the storage pool [MiB]

  • usedCapacity: Used capacity of the storage pool [MiB]

  • freeCapacity: Free capacity of the storage pool [MiB]

  • totalPhysicalCapacity: Total physical capacity of the storage pool [MiB]

  • metaDataPhysicalCapacity: Capacity for control information in the total physical capacity of the storage pool [MiB]

  • reservedPhysicalCapacity: Area that is reserved internally for other than control information and that cannot be used for redundancy in the valid physical capacity of the storage pool [MiB]

  • usablePhysicalCapacity: Capacity that can be used as logical capacity in the valid physical capacity of the storage pool [MiB]

  • blockedPhysicalCapacity: Blocked capacity in the valid physical capacity of the storage pool [MiB]

  • capacityManage: Capacity management

    • usedCapacityRate: Usage rate [%]

    • maximumReserveRate: Maximum reserve rate [%]

    • thresholdWarning: Warning threshold [%]

    • thresholdDepletion: Depletion threshold [%]

    • thresholdStorageControllerDepletion: Depletion threshold of the storage controller that manages the storage pool [%]

  • savingEffects: Effect of the data reduction function on the storage pool

    • efficiencyDataReduction: Ratio of the data capacity before and after capacity saving by the Data reduction function [%]

    • preCapacityDataReduction: Data capacity before capacity saving by the Data reduction function [MiB]

    • postCapacityDataReduction: Data capacity after capacity saving by the Data reduction function [MiB]

    • totalEfficiencyStatus: Status of total efficiency

    • dataReductionWithoutSystemDataStatus: Status of the capacity saving effect by the Data reduction function

    • totalEfficiency: Ratio of total efficiency [%]

    • dataReductionWithoutSystemData: Ratio of reduction efficiency in the entire storage pool after capacity saving by the Data reduction function [%]

    • preCapacityDataReductionWithoutSystemData: Capacity of the entire storage pool before capacity saving by the Data reduction function [MiB]

    • postCapacityDataReductionWithoutSystemData: Capacity of the entire storage pool after capacity saving by the Data reduction function [MiB]

    • calculationStartTime: Date and time the calculation started

    • calculationEndTime: Date and time the calculation ended

  • numberOfVolumes: Number of volumes in each storage pool

  • redundantPolicy: User data protection method

  • redundantType: User data protection type

  • dataRedundancy: Redundancy of user data

  • storageControllerCapacitiesGeneralStatus: Summary information about the capacity status (capacityStatus) of all the storage controllers managing the storage pool

  • totalVolumeCapacity: Total capacity of volumes that have been created on the applicable storage controller [MiB]

  • provisionedVolumeCapacity: Capacity of provisioned volumes that have been created on the applicable storage controller [MiB]

  • otherVolumeCapacity: Capacity of other volumes that have been created on the applicable storage controller [MiB]

  • temporaryVolumeCapacity: Temporary capacity of volumes that have been created on the applicable storage controller [MiB]

  • rebuildCapacityPolicy: Rebuild capacity policy

  • rebuildCapacityResourceSetting: Resource type and the number of resources for the rebuild capacity

    • numberOfTolerableDriveFailures: Tolerable number of drive failures

  • rebuildCapacityStatus: Rebuild capacity allocation status

  • rebuildableResources: Rebuildable resources

    • numberOfDrives: Rebuildable resources

  • encryptionStatus: Status of storage pool data encryption

    (Cloud) "DependsOnCloudService" when the storage pool encryption settings is disabled.

Note:

totalEfficiency [%] indicates the used capacity reduction effect achieved by the volume creation function, snapshot function, and data reduction function.

This is an average ratio [%], where the ratio of usedCapacity [MiB] (used capacity of the storage pool) to totalVolumeCapacity [MiB] (total capacity of created volumes) is calculated for each storage controller, and then weighted according to the total capacity of the created volumes for each storage controller. The larger the total capacity of created volumes of a storage controller is, the more the capacity reduction effect of that storage controller are reflected to the totalEfficiency value.

For example, if the total capacity of created volumes is 1,000 for each of the storage controllers and the used capacity of the storage pool is 50, totalEfficiency of 2,000 [%] is output by using a REST API or CLI.

In VSP One SDS Block Administrator, the value corresponding to totalEfficiency is displayed as "20.00:1" in the dashboard window (Total Efficiency) and the Storage Pool window (TOTAL EFFICIENCY). Also, in the dashboard window of the VSP One SDS Block Administrator, if the ratio is greater than 9,999,999:100, ">99999.99:1" is displayed.

When snapshot volumes are used, the used storage pool capacity can be reduced by storing only the differential data between P-VOL and S-VOL. Therefore, the value of totalEfficiency is larger than that when snapshot volumes are not included, even if the total capacity of created volumes is the same.

When storage pool expansion processing is being performed and KARS16017-I, KARS16020-I, KARS16022-I, or KARS16081-I is output, the value of totalEfficiency might become larger even when snapshot operations are not being performed. Note that snapshot operations refer to preparation (for obtaining snapshots) and obtaining, deleting, and restoring snapshots.

  • Required role: Security, Storage, RemoteCopy, Monitor, Service, or Resource

Obtain a list of information about storage pools.

REST API: GET /v1/objects/pools

CLI: pool_list