Getting information about a specific volume

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/simple/v1/objects/volumes/object-ID

Request message

Object ID

Specify the id value obtained by getting information about volumes.

Attribute	Type	Description
id	int	(Required) Volume ID

Query parameters

None.

Body

None.

Response message

Body

The following is an example of getting information about a volume with ID 100:

{
  "id": 100,
  "nickname": "JH-26216_DP",
  "poolId": 63,
  "poolName": "NASOS",
  "totalCapacity": 1024,
  "usedCapacity": 42,
  "freeCapacity": 982,
  "reservedCapacity": 0,
  "savingSetting": "DISABLE",
  "capacitySavingStatus": "Rehydrating",
  "capacitySavingProgress": 40,
  "numberOfConnectingServers": 2,
  "numberOfSnapshots": 2,
  "luns": [
    {
      "lun": 1,
      "serverId": 10,
      "portId": "CL1-A"
    },
    {
      "lun": 1,
      "serverId": 11,
      "portId": "CL2-A"
    }
  ], 
  "volumeTypes": []
}

The obtained attributes include the following attributes, in addition to the attributes obtained when volume information is obtained:

Attribute	Type	Description
freeCapacity	long	Free space in the volume (MiB) The total capacity of the volume appears when the volume is being created or deleted.
reservedCapacity	long	Capacity of the reserved pages in the volume (MiB)
savingSetting	string	Whether capacity saving (deduplication and compression) is enabled: DEDUPLICATION_AND_COMPRESSION: Deduplication and compression is enabled. COMPRESSION: Compression is enabled. DISABLE: No settings are specified.
capacitySavingStatus	string	Setting of the capacity saving (deduplication and compression) Disabled: The capacity saving is disabled. Enabled: The capacity saving is enabled. Rehydrating: The capacity saving is being disabled. Enabling: The capacity saving is being enabled. Deleting: The volumes for which the capacity saving is enabled are being deleted. Failed: The data on the deduplication system data volumes is invalid.
capacitySavingProgress	int	Progress rate of the capacity saving (deduplication and compression) (%)
luns	object[]	Array of LUN configuration information: lun (int): LU number serverId (int): Server ID portId (string): ID of the port to which the LUN is assigned

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/volumes/100