EMC ViPR REST API

Search (SHIFT+S)

API Reference


Get Zone Capacities

GET /vdc/capacities

List all VirtualPool capacities under the zone grouped by varray


Required Roles

Requires one of the following roles:

  • SYSTEM_ADMIN
  • SYSTEM_MONITOR

Response Body

List of VirtualPool capacities

Field Description Type Notes
<vdc_capacities>
<varrays>
<varray>     0-* Elements
<id> URI
<varray_vpool_capacity>     0-* Elements
<id> URI
<capacity>    
<free_gb> The free storage capacity of the specified VirtualPool or VirtualArray. String
<net_free_gb> The net free storage capacity of the specified VirtualPool or VirtualArray. String
<used_gb> The used storage capacity of the specified VirtualPool or VirtualArray. String
<provisioned_gb> The subscribed storage capacity of the specified VirtualPool or VirtualArray. String
<percent_used> The actual used percent of the usable capacity of the specified VirtualPool or VirtualArray. String
<percent_provisioned> The provisioned percent of the usable capacity of the specified VirtualPool or VirtualArray. String
</capacity>      
</varray_vpool_capacity>      
</varray>      
</varrays>
</vdc_capacities>

Examples

Request
GET https://192.168.0.0:4443/vdc/capacities HTTP/1.1 

Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>
Response
HTTP/1.1 200 OK 
Content-Type: application/xml 

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
     <vdc_capacities>
          <varrays>
               <varray>
                    <id>urn:storageos:VirtualArray:ae316135-5742-4f40-b4b0-8d38d9604917:</id>
               </varray>
               <varray>
                    <id>urn:storageos:VirtualArray:110acf4a-2459-4025-adff-ce429fc4c5c3:</id>
                    <varray_vpool_capacity>
                         <id>urn:storageos:VirtualPool:18af14df-1f7e-4883-a0bd-44aee9372407:</id>
                         <capacity>
                              <free_gb>108125</free_gb>
                              <used_gb>0</used_gb>
                              <provisioned_gb>0</provisioned_gb>
                              <percent_used>0</percent_used>
                              <percent_provisioned>0</percent_provisioned>
                         </capacity>
                    </varray_vpool_capacity>
                    <varray_vpool_capacity>
                         <id>urn:storageos:VirtualPool:2567045e-e16f-4aa1-930a-dfbc09917c97:</id>
                         <capacity>
                              <free_gb>108125</free_gb>
                              <used_gb>19</used_gb>
                              <provisioned_gb>10</provisioned_gb>
                              <percent_used>1</percent_used>
                              <percent_provisioned>1</percent_provisioned>
                         </capacity>
                    </varray_vpool_capacity>
                    <varray_vpool_capacity>
                         <id>urn:storageos:VirtualPool:48a74fce-c654-4272-b407-2aa14c2b1095:</id>
                         <capacity>
                              <free_gb>108125</free_gb>
                              <used_gb>10</used_gb>
                              <provisioned_gb>3</provisioned_gb>
                              <percent_used>1</percent_used>
                              <percent_provisioned>1</percent_provisioned>
                         </capacity>
                    </varray_vpool_capacity>
                    <varray_vpool_capacity>
                         <id>urn:storageos:VirtualPool:bf7104ec-3db2-4dcb-9e0d-7232a4460aea:</id>
                         <capacity>
                              <free_gb>108125</free_gb>
                              <used_gb>0</used_gb>
                              <provisioned_gb>0</provisioned_gb>
                              <percent_used>0</percent_used>
                              <percent_provisioned>0</percent_provisioned>
                         </capacity>
                   </varray_vpool_capacity>
              </varray>
              <varray>
                   <id>urn:storageos:VirtualArray:88543171-9a1b-4133-ac71-d93990d3bebd:</id>
              </varray>
         </varrays>
      </vdc_capacities>