Virtual Storage Resource element object

A virtual storage resource defines the virtualized view of a storage adapter as seen by a partition.

Table 1. Virtual Storage Resource element object properties
Name Qualifier Type Description
element-id String (36) The unique identifier for the virtual storage resource instance.
element-uri String/ URI The canonical URI path for the Virtual Storage Resource element object, of the form /api/storage-groups/{storage-group-id}/virtual-storage-resources/{virtual-storage-resource-id}, where {storage-group-id} is the object-id of the containing storage group, and {virtual-storage-resource-id} is the element-id of this virtual storage resource.
parent String/ URI The parent of a virtual storage resource is its owning storage group, so the parent value is the canonical URI path for the storage group.
class String (24) The class of a virtual storage resource element object is "virtual-storage-resource".
name (w)(pc) String (1-64) The display name specified for the virtual storage resource. The length and character requirements on this property are the same as those of the name property described in the Base managed object properties schema. Names must be unique to the other virtual storage resources within the parent storage group.
description (w)(pc) String (0-1024) Arbitrary text providing additional descriptive information about the virtual storage resource.

Default: an empty string

partition-uri String/ URI The canonical URI path of the partition to which this virtual storage resource is attached
device-number (w)(pc) String (4)

Device number of the virtual storage resource.

The value must be a 4-digit lower case hexadecimal. The value must be unique across the device numbers of all other virtual storage resource elements and all instances of the objects listed in Channel-based device numbers of the partition identified by partition-uri.

Default value: Auto-generated

adapter-port-uri (w)(pc) String/ URI The canonical URI path of the adapter Storage Port element to which this virtual storage resource is associated.

The type field of the parent adapter must be "fcp".

The value of this property will be null if a candidate adapter has not been discovered to back this virtual storage resource. This value may not be set to null.

This property may only be written after the virtual resource has been fulfilled, as indicated by a non-null current value.

world-wide-port-name String (16) A 16-character lower case hexadecimal string that contains the World Wide Port Name of the FCP virtual storage resource.
world-wide-port-name-info world-wide-port-name-info object Information about the worldwide port name allocated to the virtual storage resource. The element is an instance of a world-wide-port-name-info nested object, as described in Table 2.
degraded-reasons (pc) Array of String Enum The list of reasons for the degradation of the virtual storage resource. One or more of the following:
  • "adapter" - The status of the backing adapter of the virtual storage resource is either "service" or "exceptions".
  • "storage-configuration" - The virtual storage resource is not able to access some of the volumes.

If the status of the partition that this virtual storage resource is associated with is neither "degraded" nor "reservation-error", or the support for this property is not available on the CPC associated with the parent storage group, this list will be empty.

A world-wide-port-name-info object defines properties relating to a single worldwide port name (WWPN). Each world-wide-port-name-info object contains the following fields.

Table 2. world-wide-port-name-info object: properties
Name Type Description
world-wide-port-name String (16) A 16-character lower case hexadecimal string that contains the world wide port name of the FCP virtual storage resource.
status String Enum The current status of the worldwide port name. Values:
  • "validated" - The CPC can sense all the storage volumes defined in the storage group using this WWPN.
  • "not-validated" - The CPC is unable to sense one or more of the storage volumes using this WWPN.
  • "unknown" - The WWPN status is unknown. This value will only appear in property change notifications for WWPNs that are removed from the parent storage group's unassigned-world-wide-port-names list property.
  • "incomplete" - The CPC is unable to sense all of the storage volumes defined in the storage group using this WWPN which were sensed and validated before.