EMC ViPR REST API

Search (SHIFT+S)

API Reference


Get Virtual Array Storage Pools

GET /vdc/varrays/{id}/storage-pools

Returns the storage pools for the VirtualArray with the passed id. When the VirtualArray has been explicitly assigned to one or more storage pools, this API will return the ids of those storage pools. VirtualArrays can be explicitly assigned to storage pools when a storage pool is created or later by modifying the storage pool after it has been created.

Whether or not a VirtualArray has been explicitly assigned to any storage pools the VirtualArray may still have implicit associations with one or more storage pools due to the VirtualArray's network connectivity. That is, a network resides in a VirtualArray and may contain storage ports. This implies that these storage ports reside in the VirtualArray, which further implies that the storage system and any storage pools on that storage system also reside in the VirtualArray. If the VirtualArray has no explicit assignments, but does have implicit associations, the API will instead return those storage pools implicitly associated.

The API provides the ability to force the return of the list of storage pools implicitly associated with the VirtualArray using the request parameter "network_connectivity". Passing this parameter with a value of "true" will return the ids of the storage pools implicitly associated with the VirtualArray as described.

idthe URN of a ViPR VirtualArray.

Query Parameters

network_connectivitytrue to use the network connectivity to get the list of storage pools implicitly connected to the VirtualArray.

Required Roles

Requires one of the following roles:

  • SYSTEM_ADMIN
  • SYSTEM_MONITOR

Response Body

The ids of the storage pools associated with the VirtualArray.

Field Description Type Notes
<storage_pools>
<storage_pool>     0-* Elements
<name> The name of the resource String
<id> ViPR ID of the related object URI
<link> A hyperlink to the related object
</storage_pool>      
</storage_pools>

Examples

Request
GET https://192.168.0.0:4443/vdc/varrays/urn:storageos:VirtualArray:05b2ed06-064a-4869-835e-5d2e002868fe:/storage-pools 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"?>
<storage_pools>
  <storage_pool>
    <id>urn:storageos:StoragePool:62171f79-2e6d-47db-b303-32c856062c29:</id>
    <link href="/vdc/storage-systems/urn:storageos:StorageSystem:a1895790-5977-4115-a9f5-b70d033da537:/storage-pools/urn:storageos:StoragePool:62171f79-2e6d-47db-b303-32c856062c29:" rel="self"/>
    <name>ISILON+6805ca00ad4426b77a51381b1ff2f2af5a41+POOL+x200_5.5tb_200gb-ssd_6gb</name>
  </storage_pool>
</storage_pools>