Retrieving basic information of all volumes

Hi,

You can get this data at the pool level with the REST API, but not at the device/volume level.

To get the pool names, send a POST to URI https://ip.ip.ip.ip:8443/univmax/restapi/performance/ThinPool/keys with a body of {"thinPoolKeyParam":{"symmetrixId":"000195701111"}}. You'll want to replace your ip and symmetrixId as appropriate. This will also give you the time range of data that Unisphere has available for these pools.

Once you have that, you can query an individual pool with a POST to URI https://ip.ip.ip.ip:8443/univmax/restapi/performance/ThinPool/metrics with a body of {"thinPoolParam":{ "startDate" : "1394142900000", "endDate" : "1394145000000", "symmetrixId" : "000195701111", "poolId" : "POOL_NAME", "metrics" : ["ALLOCATED_POOL_CAPACITY_GB", "USED_POOL_CAPACITY_GB", "TOTAL_POOL_CAPACITY_GB"] } }. Again, replace the symmetrixId, POOL_NAME, and startDate/endDate with values relevant to your system.

If getting this information at the pool level is not granular enough, then perhaps you can use the XML output from SYMCLI instead of the REST API?

Hope that helps,

- Sean

Here is the output. Sharing it with everyone else.

Step 1

- The URL I post to retrieve the pools:

https://localhost:8443/univmax/restapi/performance/ThinPool/keys

- The JSON in the body:

{"thinPoolKeyParam":{"symmetrixId":"000295900223"}}

- The output:

{

"poolKeyResult": {

"poolInfo": [

      {

"poolId": "t4_6r6_sata",

"firstAvailableDate": 1395144600000,

"lastAvailableDate": 1395749400000

      },

      {

"poolId": "t1_3r5_efd",

"firstAvailableDate": 1395144600000,

        "lastAvailableDate": 1395749400000

      },

      {

"poolId": "t3_3r5_fc",

"firstAvailableDate": 1395144600000,

"lastAvailableDate": 1395749400000

      }

    ]

  }

}

Step 2

- The URL I post to to retrieve the poolID

https://localhost:8443/univmax/restapi/performance/ThinPool/metrics

- The JSON in the body:

{"thinPoolParam":{ "startDate" : "1364141250000", "endDate" : "13956772170000", "symmetrixId" : "000295900223", "poolId" : "t4_6r6_sata", "metrics" : ["ALLOCATED_POOL_CAPACITY_GB", "USED_POOL_CAPACITY_GB", "TOTAL_POOL_CAPACITY_GB"] } }

- The output:

"iterator": {

"resultList": {

"result": [

        {

"ALLOCATED_POOL_CAPACITY_GB": 126769.53,

"TOTAL_POOL_CAPACITY_GB": 305087.88,

"USED_POOL_CAPACITY_GB": 126769.53,

"timestamp": 1395144600000

        },

        {

"ALLOCATED_POOL_CAPACITY_GB": 126769.53,

"TOTAL_POOL_CAPACITY_GB": 305087.88,

"USED_POOL_CAPACITY_GB": 126769.53,

"timestamp": 1395144900000

        },

        {

"ALLOCATED_POOL_CAPACITY_GB": 126769.53,

"TOTAL_POOL_CAPACITY_GB": 305087.88,

"USED_POOL_CAPACITY_GB": 126769.53,

"timestamp": 1395145200000

        },

        {

"ALLOCATED_POOL_CAPACITY_GB": 125639.65,

"TOTAL_POOL_CAPACITY_GB": 305087.88,

"USED_POOL_CAPACITY_GB": 125639.65,

"timestamp": 1395145500000

        },

Etc etc.

Thanks in advance for your reply!

Junte,

The first query I posted will show you the pool names. You should see a JSON key/value pair with keys named "poolId" and values with the names of the pools. For example, in this case the pool name is TF62_TH3CF -- { "poolId": "TF62_TH3CF",  "firstAvailableDate" : 1394142900000, "lastAvailableDate": 139414500000 }

If you can post the output here (or email it to me -- firstname.lastname at emc.com), I can tell you where the pool names are in the output.

For getting the device level capacity information via SYMCLI's XML output, try "symcfg -sid list -tdev -gb -output xml_e". Or, if you have traditional volumes (not VP), you can use "symdev -sid list." You can then parse the output with the language and XML module of your choice. I have an example of this here -- Parsing SYMCLI’s XML Output with Python.

Thanks,

- Sean

Hey folks,

Sorry for the thread necromancy but I'm wondering if anyone has solved this issue using the new API available for Unisphere for VMAX? I'm currently using the V8.0.3.5 (target) version of Unisphere for VMAX vApp against a VMAX100K and I'm after exactly the same details as OP.

I can get the volume id, assigned names and assigned total capacity via the newer API however I can't seem to get anything for how much each volume has consumed - at least it seems non-obvious to me.

I *can* see the consumed vs available via the sloprovisioning/srp for the thin pool in general but I'd like to be able to drill down further if possible.

As I'm using the vApp I'd rather not resort to setting up a separate Solution Enabler server.

Cheers.

Russell.

Russell,

if you navigate into the storage group for the volumes in question from the SLO dashboard, you can select and double click.  On the Top right of the screen you will see Related Objects, from here click into Volumes and youw ill see what each is consuming.

You can also run the Storage Groups Demands report directly from the Storage Groups Dashboard and that will tell you how much space you are consuming on a storage group level as well as how much snapshot space you are consuming.

Let me know if this helps and answers

Edit: Just noted you are looking for the REST API function.. BRB

Hi Paul,

Just noticed your post edit. Yes indeed - I'm looking for a method to retrieve the capacity consumed for a volume (rather than total capacity of the volume!) via the REST API so I can integrate it with some internal reporting tools that we use in our company.

Thanks.

Russell.

Russell,

it doesn't look like this has been implemented yet, we'll get an enhancement request on your behalf.

One option for now is to run the commands to gather this information from the cli

symcfg -sid xxx list -tdev -bound -detail -output XML

This should give you what you need.

Thanks for the confirmation - the enhancement request is appreciated.

I guess I'm going to have to get the CLI environment talking to the SE on the vApp

Cheers.

Russell

Hello Paul,

Is this enhancement request now in place ? I was attempting to get the consumed capacity of a volume this afternoon and did not have much luck ( I also posted a question regarding the same moments go ). Unsure if the url is formatted correctly -

univmax/restapi/provisioning/symmetrix/ /volume/0F222

Thanks

Ray,

the allocated percentage is available on the REST call you have posted.  If this is what you are after you should be all set.