Getting information about a specific external parity group

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request gets information about a specific external parity group by specifying the external parity group number.

Execution permission

Storage Administrator (View Only)

Request line

GET base-URL/v1/objects/external-parity-groups/object-ID

Request message

Object ID

Specify the value of externalParityGroupId that was obtained by the processing to get information about the external parity group.

Attribute

Type

Description

externalParityGroupId

string

(Required) External parity group number

Query parameters

None.

Body

None.

Response message

Body
{
  "externalParityGroupId": "1-2",
  "numOfLdevs": 1,
  "usedCapacityRate": 100,
  "availableVolumeCapacity": 0,
  "emulationType": "OPEN-V",
  "clprId": 0,
  "externalProductId": "OPEN-V",
  "spaces": [
    {
      "partitionNumber": 0,
      "ldevId": 49153,
      "status": "NML",
      "lbaLocation": "0x000000000000",
      "lbaSize": "0x000001e00000"
    }
  ],
  "availableVolumeCapacityInKB": 0
}

Attribute

Type

Description

externalParityGroupId

string

External parity group number

numOfLdevs

int

Number of LDEVs allocated to the external parity group

usedCapacityRate

int

Usage rate of the external parity group

availableVolumeCapacity

long

Available capacity (GB)

The amount of free space is output.

If the capacity is below 1 GB, the value is ignored and 0 is assumed.

availableVolumeCapacityInKB

long

Available capacity (KB)

The amount of free space is output.

emulationType

string

Emulation type of the external parity group

clprId

int

Number of CLPR to which the external parity group belongs

externalProductId

string

Storage system that is connected using the external storage connection functionality of Universal Volume Manager

spaces

objects[]

For the free space and the LDEV defined in the specified external parity group, the following attributes are output:
  • partitionNumber (long)

    Number of a partition created as a result of partitioning of an external parity group

  • ldevId (int)

    LDEV number

  • status (string)

    LDEV status

    • NML: The LDEV is implemented, or the free space is determined.
    • REG: The LDEV is being created.
    • DEL: The LDEV is being deleted.
  • lbaLocation (string)

    Starting location of the LBA of the partition in the external parity group (in a multiple of 512 bytes)

  • lbaSize (string)

    Size of the partition in the external parity group (in a multiple of 512 bytes)

Status codes

For details on the status codes of the request for this operation, see the description on HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/external-parity-groups/1-1