Inventory service data

Information about the Storage Groups managed by the HMC can be optionally included in the inventory data provided by the Inventory Service.

Inventory entries for storage group objects are included in the response to the Inventory Service's Get Inventory operation when the request specifies (explicitly by class, implicitly through a containing category, or by default) that objects of class "storage-group" are to be included. Information for a particular storage group is included only if the API user has object-access permission to that object.

For each storage group to be included, the inventory response array includes the following:

  • An array entry for the storage group object itself. This entry is a JSON object with the same contents as is specified in the Response body contents section for Get Storage Group Properties. That is, the data provided is the same as would be provided if a Get Storage Group Properties operation were requested targeting this object.
  • An array entry for each storage volume element associated with the storage group. For each such storage volume, an entry is included that is a JSON object with the same contents as is specified in the Response body contents section for Get Storage Volume Properties.
  • An array entry for each virtual storage resource element associated with the storage group. For each such virtual storage resource, an entry is included that is a JSON object with the same contents as is specified in the Response body contents section for Get Virtual Storage Resource Properties.

Sample inventory data

The following fragment is an example of the JSON objects that would be included in the Get Inventory response to describe a storage group. These objects would appear as multiple array entries in the response array:

Figure 1. Storage Group object: Sample inventory data - Response (Part 1)
{
   "active-connectivity":null,
   "active-max-partitions":null,
   "candidate-adapter-port-uris":[
      "/api/adapters/f0f668e8-9fe7-11e8-bc9a-fa163e3c2af4/storage-ports/0",
      "/api/adapters/f4f1479c-9fe7-11e8-bc9a-fa163e3c2af4/storage-ports/0"
   ],
   "class":"storage-group",
   "connectivity":2,
   "cpc-uri":"/api/cpcs/3aadfe48-128c-3766-8f51-37738f784591",
   "description":"",
   "direct-connection-count":0,
   "fulfillment-state":"pending",
   "max-partitions":2,
   "name":"FCP Group",
   "object-id":"2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4",
   "object-uri":"/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4",
   "parent":"/api/console",
   "shared":true,
   "storage-volume-uris":[
      "/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/storage-volumes/
        2d6355ba-9fe9-11e8-b163-fa163e3c2af4",
      "/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/storage-volumes/
        2d71eeae-9fe9-11e8-b163-fa163e3c2af4"
   ],
   "type":"fcp",
   "unassigned-world-wide-port-names":[
      {
         "status":"not-validated",
         "world-wide-port-name":"a1b2c3d4e5f60006"
      },
      {
         "status":"not-validated",
         "world-wide-port-name":"a1b2c3d4e5f60005"
      }
   ],
   "virtual-storage-resource-uris":[
      "/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/virtual-storage-resources/
        4ca56526-9fe9-11e8-b6db-fa163e3c2af4",
      "/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/virtual-storage-resources/
        4ce7feea-9fe9-11e8-b6db-fa163e3c2af4"
   ]
},
{
   "active-size":null,
   "class":"storage-volume",
   "description":"",
   "element-id":"2d6355ba-9fe9-11e8-b163-fa163e3c2af4",
   "element-uri":"/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/
     storage-volumes/2d6355ba-9fe9-11e8-b163-fa163e3c2af4",
   "fulfillment-state":"pending",
   "name":"1.00 GiB Boot",
   "parent-storage-group-uris":[
      "/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4"
   ],
   "size":1.0,
   "usage":"boot",
   "uuid":"a1b2c3d4e5f6000325d4677ab2320e54"
},
Figure 2. Storage Group object: Sample inventory data - Response (Part 2)
{
   "adapter-port-uri":"/api/adapters/f0f668e8-9fe7-11e8-bc9a-fa163e3c2af4/storage-ports/0",
   "class":"virtual-storage-resource",
   "description":"",
   "device-number":"0000",
   "element-id":"4ca56526-9fe9-11e8-b6db-fa163e3c2af4",
   "element-uri":"/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4/virtual-storage-
     resources/4ca56526-9fe9-11e8-b6db-fa163e3c2af4",
   "name":"vhba_FCP Group0",
   "parent":"/api/storage-groups/2cbc7c2c-9fe9-11e8-b163-fa163e3c2af4",
   "partition-uri":"/api/partitions/4bf93d46-9fe9-11e8-b6db-fa163e3c2af4",
   "world-wide-port-name":"a1b2c3d4e5f60002"
   "world-wide-port-name-info":{
     "status":"not-validated", 
     "world-wide-port-name":"a1b2c3d4e5f60002"
     }
}