ViPR 2.1 - Create and configure a ViPR virtual array using the ViPR REST API

Overview

ViPR system administrators can use the ViPR REST API to create a virtual array, and assign an ACL to the virtual array. The REST API is also used to configure the networks, storage ports, and storage pools assigned to the virtual array.

This article is part of a series

Virtual arrays can be added to ViPR at anytime. If, however, you are setting up the ViPR Controller virtual data center for the first time, before you continue to provision storage, complete the following steps.

Authenticate with the ViPR REST API
Add physical assets to ViPR:
Create ViPR virtual assets:
1. Create and configure a virtual array
2. Create virtual pools:
  - Create block virtual pools
  - Create file virtual pools

Create a virtual array and assign an ACL

Before you begin

Authenticate with the ViPR REST API as a System Administrator to create or edit virtual arrays.
Virtual array configuration requirements and recommendations.
At a minimum, a virtual array must include at least one network, and one storage system connected to the network.
- Storage systems can be added directly to the virtual array, or can be brought into the virtual array with the networks.
- Networks can be added directly to the virtual array, or can be brought in with the storage systems, if the networks were previously added to the ViPR physical assets.
Optionally, physical storage ports, and storage pools associated with the storage systems in the virtual array, can be assigned for use in the virtual array. When assigned, only those storage ports and storage pools will be used as resources when storage is provisioned from the virtual array.
A description and complete list of parameters for the REST API methods used in this article are described in the EMC ViPR REST API Reference.

The following steps describe how to create a virtual array in ViPR using the REST API. To use the ViPR UI to create a virtual array in ViPR see the Create and Configure ViPR Virtual Arrays article.

Procedure

Create a virtual array by sending a POST/vdc/varrays.

The request returns the representation of the new virtual array.

Request

POST https://<ViPR_VIP>:4443/vdc/varrays
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<varray_create>
     <name>Phoenix</name>
     <auto_san_zoning>true</auto_san_zoning>
</varray_create>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<varray>
    <creation_time>1399841344524</creation_time>
    <global>false</global>
    <id>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1"/>
    <name>Phoenix</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <auto_san_zoning>true</auto_san_zoning>
    <block_settings>
        <auto_san_zoning>true</auto_san_zoning>
    </block_settings>
    <object_settings>
        <device_registered>false</device_registered>
        <protection_type></protection_type>
    </object_settings>
</varray>

Create an ACL for the virtual array and assign the tenant user to the ACL by sending a PUT /vdc/varrays/{Varray_URN}/acl. You can use GET /tenant to get the ID of your own tenant or GET /tenants/bulk to return a list of all tenants in ViPR.

Request

PUT https://<ViPR_VIP>:4443/vdc/varrays/urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1/acl
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<acl_assignment_changes>
     <add>
           <privilege>USE</privilege>
           <tenant>urn:storageos:TenantOrg:6c7dde31-ec48-4028-8672-5e74f5754656:global</tenant>
     </add>
</acl_assignment_changes>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <acl_assignments>
       <acl_assignment>
            <privilege>USE</privilege>
            <tenant>urn:storageos:TenantOrg:c7ba7600-1a02-4558-954d-3de642eeacce:global</tenant>
       </acl_assignment>
       <acl_assignment>
            <privilege>USE</privilege>
            <tenant>urn:storageos:TenantOrg:6c7dde31-ec48-4028-8672-5e74f5754656:global</tenant>
       </acl_assignment>
  </acl_assignments>

Add and configure the networks for block storage in the virtual array

Fibre Channel networks are automatically added, discovered, and registered in ViPR when the fabric switch is added to the ViPR physical assets.

When selecting the Fibre Channel networks to add to the virtual array the storage systems and hosts to which the storage will be provisioned must be configured on the same network.
If the hosts were added to ViPR, and not discovered, the host ports must be manually added to the networks.
Optionally, storage ports can be added to the network to control which ports will be used when the storage is provisioned on the host.

Add an existing fibre channel network to a virtual array

Fibre Channel networks are automatically added, discovered, and registered in ViPR when the fabric switch is added to the ViPR physical assets.

Before you begin

Procedure

You can determine which networks are available using GET /vdc/networks.

Request

GET https://<ViPR_VIP>:4443/vdc/networks
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<networks>
    <network>
        <id>urn:storageos:Network:079b9be1-2342-41a0-84e3-26b4d0fd108a:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:079b9be1-2342-41a0-84e3-26b4d0fd108a:vdc1"/>
        <name>FABRIC_vplex154nbr2-10:00:00:27:f8:58:f6:c2</name>
    </network>
    <network>
        <id>urn:storageos:Network:922f1519-e8ee-438a-a11a-b7f3a139e0b3:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:922f1519-e8ee-438a-a11a-b7f3a139e0b3:vdc1"/>
        <name>VSAN_56</name>
    </network>
    <network>
        <id>urn:storageos:Network:c67c9728-4d89-4e57-a345-dc88bf1213ec:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:c67c9728-4d89-4e57-a345-dc88bf1213ec:vdc1"/>
        <name>FABRIC_Brocade B FE</name>
    </network>
    <network>
        <id>urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1"/>
        <name>VSAN_57</name>
    </network>
</networks>

Use GET /vdc/networks/{Network_URN} to obtain further details about specific networks.

Request

GET https://<ViPR_VIP>:4443/vdc/networks/urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1398806587983</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1"/>
    <name>VSAN_57</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <native_guid>FC+MDS+20:39:00:2A:6A:3E:3D:41</native_guid>
    <assigned_varrays>
        <assigned_varray>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</assigned_varray>
    </assigned_varrays>
    <connected_varrays>
        <connected_varray>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</connected_varray>
    </connected_varrays>
    <discovered>true</discovered>
    <endpoints>
        <endpoint>50:00:14:42:80:60:0B:13</endpoint>
        <endpoint>50:00:14:42:90:60:0B:13</endpoint>
        <endpoint>50:06:01:6B:46:E0:66:37</endpoint>
        <endpoint>50:00:09:73:F0:06:71:40</endpoint>
        <endpoint>50:06:01:63:46:E0:66:37</endpoint>
        <endpoint>50:00:09:73:F0:06:71:44</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>50:00:14:42:80:60:0B:13</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:06:01:6B:46:E0:66:37</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:14:42:90:60:0B:13</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:09:73:F0:06:71:40</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:06:01:63:46:E0:66:37</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:09:73:F0:06:71:44</name>
            <value>true</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <fabric_id>57</fabric_id>
    <network_systems>
        <network_system>urn:storageos:NetworkSystem:74a20311-cd89-4ce7-90b3-54a3a8bc814a:vdc1</network_system>
    </network_systems>
    <registration_status>REGISTERED</registration_status>
    <transport_type>FC</transport_type>
    <varray>
        <id>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1"/>
    </varray>
</network>

Select the appropriate fiber channel network (<transport_type>FC</transport_type>), and assign the network to the virtual array by sending a PUT /vdc/networks/{Network_URN} request, including the URN of the virtual array to which the network is to be assigned in the request payload.

Request

PUT https://<ViPR_VIP>:4443/vdc/networks/urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<network_update>
     <varrays>
               <varray>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</varray>
     </varrays>
</network_update>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1398806587983</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:a0fe52d9-9683-46d8-b52d-12c6e73b7b98:vdc1"/>
    <name>VSAN_57</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <native_guid>FC+MDS+20:39:00:2A:6A:3E:3D:41</native_guid>
    <assigned_varrays>
        <assigned_varray>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</assigned_varray>
    </assigned_varrays>
    <connected_varrays>
        <connected_varray>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</connected_varray>
    </connected_varrays>
    <discovered>true</discovered>
    <endpoints>
        <endpoint>50:00:14:42:80:60:0B:13</endpoint>
        <endpoint>50:00:14:42:90:60:0B:13</endpoint>
        <endpoint>50:06:01:6B:46:E0:66:37</endpoint>
        <endpoint>50:00:09:73:F0:06:71:40</endpoint>
        <endpoint>50:06:01:63:46:E0:66:37</endpoint>
        <endpoint>50:00:09:73:F0:06:71:44</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>50:00:14:42:80:60:0B:13</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:06:01:6B:46:E0:66:37</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:14:42:90:60:0B:13</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:09:73:F0:06:71:40</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:06:01:63:46:E0:66:37</name>
            <value>true</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>50:00:09:73:F0:06:71:44</name>
            <value>true</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <fabric_id>57</fabric_id>
    <network_systems>
        <network_system>urn:storageos:NetworkSystem:74a20311-cd89-4ce7-90b3-54a3a8bc814a:vdc1</network_system>
    </network_systems>
    <registration_status>REGISTERED</registration_status>
    <transport_type>FC</transport_type>
    <varray>
        <id>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1"/>
    </varray>
</network>

Configure a new fibre channel network for a virtual array

Procedure

Get the list of virtual arrays.

Request

GET https://<ViPR_VIP>:4443/vdc/varrays
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<varrays>
    <varray>
        <id>urn:storageos:VirtualArray:69b363c5-f412-4fac-9f5d-0c5367628c17:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:69b363c5-f412-4fac-9f5d-0c5367628c17:vdc1"/>
        <name>snapshot test</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1"/>
        <name>varray_west_1</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1"/>
        <name>varray_east_1</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1"/>
        <name>varray2</name>
    </varray>
</varrays>

Using the URN of the selected virtual array, configure a new fibre channel network for the selected virtual array by sending POST /vdc/varrays/{id}/networks.

Request

POST https://<ViPR_VIP>:4443/vdc/varrays/urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1/networks
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<network_create>
    <name>FC_network_west_1</name>
    <transport_type>FC</transport_type>
    <endpoints>
          <endpoint>10:00:20:00:c9:79:f1:46 </endpoint>
          <endpoint>10:00:20:00:c9:79:f1:47 </endpoint>
    </endpoints>
</network_create>

Reponse

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1400177060451</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:e508d8b6-6738-4311-ad4d-4c582cf7b0d6:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:e508d8b6-6738-4311-ad4d-4c582cf7b0d6:vdc1"/>
    <name>FC_network_west_1</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1"/>
    </vdc>
    <native_guid></native_guid>
    <assigned_varrays>
        <assigned_varray>urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1</assigned_varray>
    </assigned_varrays>
    <connected_varrays>
        <connected_varray>urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1</connected_varray>
    </connected_varrays>
    <discovered>false</discovered>
    <endpoints>
        <endpoint>10:00:20:00:C9:79:F1:47</endpoint>
        <endpoint>10:00:20:00:C9:79:F1:46</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>10:00:20:00:C9:79:F1:47</name>
            <value>false</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>10:00:20:00:C9:79:F1:46</name>
            <value>false</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <registration_status>REGISTERED</registration_status>
    <transport_type>FC</transport_type>
    <varray>
        <id>urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1"/>
    </varray>
</network>

Add and configure the networks for file storage in a virtual array

ViPR can discover the ports of IP connected storage systems and hosts, but it cannot discover the paths between them, so it is necessary to create IP networks, and then add the host, and storage system ports, which will be provisioned together, to the same IP network.

Add an existing IP network to a virtual array

If the IP network has already been created, and configured using POST /vdc/networks, you will just need to add the network to the virtual array.

Before you begin

URN of the virtual array to which the IP network is being added.

Procedure

You can get which networks are available using GET /vdc/networks.

Request

GET https://<ViPR_VIP>:4443/vdc/networks
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<networks>
    <network>
        <id>urn:storageos:Network:b10c046f-0968-4c30-91cd-b2b34f1d7f5e:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:b10c046f-0968-4c30-91cd-b2b34f1d7f5e:vdc1"/>
        <name>FABRIC_vplex154nbr2</name>
    </network>
    <network>
        <id>urn:storageos:Network:fc2824bd-0935-43e4-a062-748b48f7f99e:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:fc2824bd-0935-43e4-a062-748b48f7f99e:vdc1"/>
        <name>FABRIC_VPlex_Meta_Fid_20</name>
    </network>
    <network>
        <id>urn:storageos:Network:abaf3cec-cdd1-4751-b9bf-ba02dafe7603:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:abaf3cec-cdd1-4751-b9bf-ba02dafe7603:vdc1"/>
        <name>FABRIC_VPLEX_WAN_lglw6208/lglw6209</name>
    </network>
    <network>
        <id>urn:storageos:Network:6c5cbf7f-d0eb-40f8-9e35-e35e2c8d5f77:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:6c5cbf7f-d0eb-40f8-9e35-e35e2c8d5f77:vdc1"/>
        <name>FABRIC_VPlex_LGL6221_FID_40</name>
    </network>
    <network>
        <id>urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1"/>
        <name>IP_network_west1</name>
    </network>
    <network>
        <id>urn:storageos:Network:602444e4-b338-4620-9e07-84247de5406d:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:602444e4-b338-4620-9e07-84247de5406d:vdc1"/>
        <name>FABRIC_Vplex_WAN-10:00:00:27:f8:58:f6:bc</name>
    </network>
    <network>
        <id>urn:storageos:Network:eff96c90-d67a-400e-9b07-2c308ba5ee51:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:eff96c90-d67a-400e-9b07-2c308ba5ee51:vdc1"/>
        <name>FABRIC_fake array fabric</name>
    </network>
    <network>
        <id>urn:storageos:Network:0776a1c7-97d6-498d-ad01-d03c9cc10925:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:0776a1c7-97d6-498d-ad01-d03c9cc10925:vdc1"/>
        <name>FABRIC_VPlex_LGL6220_FID_30-10:00:00:27:f8:58:f6:c1</name>
    </network>
    <network>
        <id>urn:storageos:Network:cb3a82dd-0202-4d6a-8f3f-3966fd817e82:vdc1</id>
        <link rel="self" href="/vdc/networks/urn:storageos:Network:cb3a82dd-0202-4d6a-8f3f-3966fd817e82:vdc1"/>
        <name>FABRIC_losam082-fabric</name>
    </network>
</networks>

Use GET /vdc/networks/{Network_URN} to get further details about a specific network.

Request

GET https://<ViPR_VIP>:4443/vdc/networks/urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1400172861659</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1"/>
    <name>IP_network_west1</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1"/>
    </vdc>
    <native_guid></native_guid>
    <discovered>false</discovered>
    <endpoints>
        <endpoint>192.168.0.10</endpoint>
        <endpoint>192.168.0.20</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>192.168.0.10</name>
            <value>false</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>192.168.0.20</name>
            <value>false</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <registration_status>REGISTERED</registration_status>
    <transport_type>IP</transport_type>
</network>

Select the appropriate network, and assign the IP network to the virtual array by sending a PUT /vdc/networks/{Network_URN} request, including the URN of the virtual array to which the network is to be assigned in the request payload. The updated network representation, with the varray added, is returned.

Request

PUT https://<ViPR_VIP>:4443/vdc/networks/urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<network_update>
     <varrays>
               <varray>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</varray>
     </varrays>
</network_update>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1400172861659</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:beb93fc4-d696-4be3-a4c9-80fab40d34b4:vdc1"/>
    <name>IP_network_west1</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1"/>
    </vdc>
    <native_guid></native_guid>
    <assigned_varrays>
        <assigned_varray>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</assigned_varray>
    </assigned_varrays>
    <connected_varrays>
        <connected_varray>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</connected_varray>
    </connected_varrays>
    <discovered>false</discovered>
    <endpoints>
        <endpoint>192.168.0.10</endpoint>
        <endpoint>192.168.0.20</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>192.168.0.10</name>
            <value>false</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>192.168.0.20</name>
            <value>false</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <registration_status>REGISTERED</registration_status>
    <transport_type>IP</transport_type>
    <varray>
        <id>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1"/>
    </varray>
</network>

Configure a new IP network for a virtual array

Procedure

Get the list of virtual arrays.

Request

GET https://<ViPR_VIP>:4443/vdc/varrays
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<varrays>
    <varray>
        <id>urn:storageos:VirtualArray:69b363c5-f412-4fac-9f5d-0c5367628c17:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:69b363c5-f412-4fac-9f5d-0c5367628c17:vdc1"/>
        <name>snapshot test</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:eed33299-3fa4-4de1-be44-73949a7a42ea:vdc1"/>
        <name>varray_west_1</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1"/>
        <name>varray_east_1</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:bd15ab0c-fc25-4256-9ccb-73dea570d65c:vdc1"/>
        <name>varray2</name>
    </varray>
</varrays>

Using the URN of the selected virtual array, configure a new IP network for the selected virtual array by sending POST /vdc/varrays/{id}/networks.

Request

POST https://<ViPR_VIP>:4443/vdc/varrays/urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1/networks
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<network_create>
    <name>IP_network_east_1</name>
    <transport_type>IP</transport_type>
    <endpoints>
          <endpoint>192.169.100.10</endpoint>
          <endpoint>192.168.100.40</endpoint>
    </endpoints>
</network_create>

Reponse

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<network>
    <creation_time>1400181561583</creation_time>
    <global>false</global>
    <id>urn:storageos:Network:f6e2d237-a770-4085-924a-0d11afdb8e6a:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/networks/urn:storageos:Network:f6e2d237-a770-4085-924a-0d11afdb8e6a:vdc1"/>
    <name>IP_network_east_1</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:030618c2-c6b2-40b0-a105-6b669983f58f:vdc1"/>
    </vdc>
    <native_guid></native_guid>
    <assigned_varrays>
        <assigned_varray>urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1</assigned_varray>
    </assigned_varrays>
    <connected_varrays>
        <connected_varray>urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1</connected_varray>
    </connected_varrays>
    <discovered>false</discovered>
    <endpoints>
        <endpoint>192.168.100.40</endpoint>
        <endpoint>192.169.100.10</endpoint>
    </endpoints>
    <endpoints_discovered>
        <endpoint_discovered>
            <name>192.168.100.40</name>
            <value>false</value>
        </endpoint_discovered>
        <endpoint_discovered>
            <name>192.169.100.10</name>
            <value>false</value>
        </endpoint_discovered>
    </endpoints_discovered>
    <registration_status>REGISTERED</registration_status>
    <transport_type>IP</transport_type>
    <varray>
        <id>urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:e6f1d340-9a32-4c4a-990d-c346125b4141:vdc1"/>
    </varray>
</network>

Optionally restrict access to storage pools by manually assigning them to a virtual array

When no specific storage pools are manually assigned to a virtual array, then all available pools from the storage arrays are available to the virtual array. Optionally, you can restrict access to certain pools by manually assigning them to a specific virtual array.

Before you begin

Authenticate with the ViPR REST API as a System Administrator.

Procedure

Get the URN of the storage system, on which the storage pools were created, by sending GET /vdc/storage-systems

This request returns a list of all of the physical storage arrays.

Request

GET https://<ViPR_VIP>:4443/vdc/storage-systems
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<storage_systems>
    <storage_system>
        <id>urn:storageos:StorageSystem:db0e84ef-2a74-46df-83e4-dbdeef92de18:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:db0e84ef-2a74-46df-83e4-dbdeef92de18:vdc1"/>
        <name>CLARIION+APM00112900836</name>
    </storage_system>
    <storage_system>
        <id>urn:storageos:StorageSystem:75e83be7-f31b-4815-9ad5-2f0493b324aa:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:75e83be7-f31b-4815-9ad5-2f0493b324aa:vdc1"/>
        <name>VPLEX+FNM00114300288:FNM00114600001</name>
    </storage_system>
    <storage_system>
        <id>urn:storageos:StorageSystem:10cdbde6-598c-465e-b1e1-08f3cf40773c:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:10cdbde6-598c-465e-b1e1-08f3cf40773c:vdc1"/>
        <name>SYMMETRIX+000195701351</name>
    </storage_system>
    <storage_system>
        <id>urn:storageos:StorageSystem:871be65d-9e64-4da9-810e-2a1ecb22dec9:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:871be65d-9e64-4da9-810e-2a1ecb22dec9:vdc1"/>
        <name>VPLEX+FNM00130900344:FNM00131100242</name>
    </storage_system>
    <storage_system>
        <id>urn:storageos:StorageSystem:7dff9b79-0544-4374-831a-39eb44dea178:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:7dff9b79-0544-4374-831a-39eb44dea178:vdc1"/>
        <name>SYMMETRIX+000198700412</name>
    </storage_system>
    <storage_system>
        <id>urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1"/>
        <name>CLARIION+APM00121202922</name>
    </storage_system>
</storage_systems>

Use the storage system URN to get detailed information about the storage array by sending a GET /vdc/storage-systems/{Storage_URN} request.

The request returns the representation of the storage system.

Request

GET https://<ViPR_VIP>:4443/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<storage_system>
    <creation_time>1398804314377</creation_time>
    <global>false</global>
    <id>urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1"/>
    <name>CLARIION+APM00121202922</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <native_guid>CLARIION+APM00121202922</native_guid>
    <compatibility_status>COMPATIBLE</compatibility_status>
    <job_discovery_status>COMPLETE</job_discovery_status>
    <last_discovery_run_time>1399841512808</last_discovery_run_time>
    <last_discovery_status_message>Unknown Status</last_discovery_status_message>
    <last_metering_run_time>1399840199821</last_metering_run_time>
    <job_metering_status>IN_PROGRESS</job_metering_status>
    <next_discovery_run_time>1399845082577</next_discovery_run_time>
    <next_metering_run_time>1399845052602</next_metering_run_time>
    <registration_status>REGISTERED</registration_status>
    <success_discovery_time>1399841512808</success_discovery_time>
    <success_metering_time>1399840199821</success_metering_time>
    <system_type>vnxblock</system_type>
    <active_provider_uri>
        <id>urn:storageos:StorageProvider:fe3892e6-8ffa-4de9-bff8-7e0bc2744b5c:vdc1</id>
        <link rel="self" href="/vdc/smis-providers/urn:storageos:StorageProvider:fe3892e6-8ffa-4de9-bff8-7e0bc2744b5c:vdc1"/>
    </active_provider_uri>
    <assocociated_systems/>
    <export_masks/>
    <firmware_version>05.32.000.5.209</firmware_version>
    <max_resources>-1</max_resources>
    <model>Rack Mounted VNX5300</model>
    <num_resources>0</num_resources>
    <protocols/>
    <smis_providers>
        <smis_provider>
            <id>urn:storageos:StorageProvider:fe3892e6-8ffa-4de9-bff8-7e0bc2744b5c:vdc1</id>
            <link rel="self" href="/vdc/smis-providers/urn:storageos:StorageProvider:fe3892e6-8ffa-4de9-bff8-7e0bc2744b5c:vdc1"/>
        </smis_provider>
    </smis_providers>
    <reachable>true</reachable>
    <connected_systems/>
    <secondary_ips/>
    <serial_number>APM00121202922</serial_number>
    <smis_port_number>5989</smis_port_number>
    <smis_provider_ip>lglw0003.lss.emc.com</smis_provider_ip>
    <smis_use_ssl>true</smis_use_ssl>
    <smis_user_name>admin</smis_user_name>
    <async_actions>
        <async_action>CreateGroupReplica</async_action>
        <async_action>CreateElementReplica</async_action>
    </async_actions>
    <supported_provisioning_type>THIN_AND_THICK</supported_provisioning_type>
    <supported_replication_types/>
</storage_system>

Get the list of virtual arrays by sending GET /vdc/varrays.

Request

GET https://<ViPR_VIP>:4443/vdc/varrays
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<varrays>
    <varray>
        <id>urn:storageos:VirtualArray:f7c47391-87ec-4f10-b2d6-6d43e600610a:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:f7c47391-87ec-4f10-b2d6-6d43e600610a:vdc1"/>
        <name>Syracuse - DR</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1"/>
        <name>Phoenix</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1"/>
        <name>New York</name>
    </varray>
    <varray>
        <id>urn:storageos:VirtualArray:b55be867-86a3-4db3-af47-b501a222b724:vdc1</id>
        <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:b55be867-86a3-4db3-af47-b501a222b724:vdc1"/>
        <name>Boston</name>
    </varray>
</varrays>

Use the virtual array URN to get detailed information about the virtual array.

Request

GET https://<ViPR_VIP>:4443/vdc/varrays/urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<varray>
    <creation_time>1399841344524</creation_time>
    <global>false</global>
    <id>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/varrays/urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1"/>
    <name>Phoenix</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <auto_san_zoning>true</auto_san_zoning>
    <block_settings>
        <auto_san_zoning>true</auto_san_zoning>
    </block_settings>
    <object_settings>
        <device_registered>false</device_registered>
        <protection_type></protection_type>
    </object_settings>
</varray>

Get the list of storage pools on the storage system by sending GET /vdc/storage-systems/{Storage_URN}/storage-pools.

Request

GET https://<ViPR_VIP>:4443/vdc/storage-systems/urn:storageos:VirtualArray:27a6a3a8-ead4-4e11-92af-7d4bc2e5f5af:vdc1/storage-pools
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<storage_pools>
    <storage_pool>
        <id>urn:storageos:StoragePool:0b28cee4-c823-4d4e-b1cb-2d0d9f8c2f2e:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:0b28cee4-c823-4d4e-b1cb-2d0d9f8c2f2e:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0000</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0004</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:7ff45894-7f95-442f-86c2-f3a9aca63866:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:7ff45894-7f95-442f-86c2-f3a9aca63866:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0002</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:ad9abdf1-aa5d-4828-81a0-3c4dba265f84:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:ad9abdf1-aa5d-4828-81a0-3c4dba265f84:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+U+Pool 0</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:b7ec3de0-fd48-4c39-92e3-164d3455cc91:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:b7ec3de0-fd48-4c39-92e3-164d3455cc91:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+U+Pool 1</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:b99fb097-0259-4c83-b186-0d23c666f647:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:b99fb097-0259-4c83-b186-0d23c666f647:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0003</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:c065a492-4752-4524-9b6a-6ecd87858746:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:c065a492-4752-4524-9b6a-6ecd87858746:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+U+Pool 2</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:c454439a-0ba4-4577-9ee0-0c1ae372ad86:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:c454439a-0ba4-4577-9ee0-0c1ae372ad86:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0014</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:d391c4d1-48f8-446e-8832-da98e991097a:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:d391c4d1-48f8-446e-8832-da98e991097a:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0013</name>
    </storage_pool>
    <storage_pool>
        <id>urn:storageos:StoragePool:e1ac89d0-e035-4b33-840e-2a734bd999f2:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:e1ac89d0-e035-4b33-840e-2a734bd999f2:vdc1"/>
        <name>CLARIION+APM00121202922+POOL+C+0001</name>
    </storage_pool>
</storage_pools>

Get the detailed information of the storage pool to add to the virtual array by sending GET /vdc/storage-systems/{Storage_URN}/storage-pools/{Pool_URN}.

Request

GET https://<ViPR_VIP>:4443/vdc/storage-systems/urn:storageos:StorageSystem:1736c44b-72dc-439d-ad47-40d308e310ef:vdc1/storage-pools/urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<storage_pool>
    <creation_time>1398804324373</creation_time>
    <global>false</global>
    <id>urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1"/>
    <name>CLARIION+APM00121202922+POOL+C+0004</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <native_guid>CLARIION+APM00121202922+POOL+C+0004</native_guid>
    <connected_varrays>urn:storageos:VirtualArray:f7c47391-87ec-4f10-b2d6-6d43e600610a:vdc1</connected_varrays>
    <tagged_varrays>urn:storageos:VirtualArray:f7c47391-87ec-4f10-b2d6-6d43e600610a:vdc1</tagged_varrays>
    <compatibility_status>COMPATIBLE</compatibility_status>
    <controller_params/>
    <copy_types>
        <copy_type>UNSYNC_UNASSOC</copy_type>
        <copy_type>SYNC</copy_type>
        <copy_type>UNSYNC_ASSOC</copy_type>
    </copy_types>
    <drive_types>
        <drive_type>NL_SAS</drive_type>
    </drive_types>
    <free_gb>3046</free_gb>
    <max_pool_utilization_percentage>75</max_pool_utilization_percentage>
    <max_resources>-1</max_resources>
    <max_thin_pool_subscription_percentage>300</max_thin_pool_subscription_percentage>
    <maximum_thick_volume_size_gb>2979</maximum_thick_volume_size_gb>
    <maximum_thin_volume_size_gb>0</maximum_thin_volume_size_gb>
    <minimum_thick_volume_size_gb>0</minimum_thick_volume_size_gb>
    <minimum_thin_volume_size_gb>0</minimum_thin_volume_size_gb>
    <operational_status>READY</operational_status>
    <percent_subscribed>17</percent_subscribed>
    <percent_used>17</percent_used>
    <pool_name>0004</pool_name>
    <pool_service_type>block</pool_service_type>
    <protocols>
        <protocol>iSCSI</protocol>
        <protocol>FC</protocol>
    </protocols>
    <raid_levels>
        <raid_level>RAID6</raid_level>
    </raid_levels>
    <registration_status>REGISTERED</registration_status>
    <storage_system>
        <id>urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1"/>
    </storage_system>
    <subscribed_gb>618</subscribed_gb>
    <supported_resource_types>THICK_ONLY</supported_resource_types>
    <thin_volume_preallocation_supported>false</thin_volume_preallocation_supported>
    <tier_utilization_percentages/>
    <usable_gb>3664</usable_gb>
    <used_gb>618</used_gb>
</storage_pool>

Assign a storage pool to the virtual array by sending PUT /vdc/storage-pools/{Pool_URN}. The URN of the virtual array to which the storage pool is being assigned is included in the request payload.

The updated representation of the virtual array is returned.

Request

PUT https://<ViPR_VIP>:4443/vdc/storage-pools/urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1
Content-Type: application/xml
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

<storage_pool_update>
     <varray_assignment_changes>
          <add>
                 <varray>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</varray>
          </add>
      </varray_assignment_changes>
</storage_pool_update>

Response

HTTP 200 OK
Content-Type: application/xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<storage_pool>
    <creation_time>1398804324373</creation_time>
    <global>false</global>
    <id>urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1</id>
    <inactive>false</inactive>
    <internal>false</internal>
    <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1/storage-pools/urn:storageos:StoragePool:75f3a0bb-3414-439b-b88b-26778be9403d:vdc1"/>
    <name>CLARIION+APM00121202922+POOL+C+0004</name>
    <remote>false</remote>
    <tags/>
    <vdc>
        <id>urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1</id>
        <link rel="self" href="/vdc/urn:storageos:VirtualDataCenter:440b70de-fd36-4361-a455-b6ca65fb8228:vdc1"/>
    </vdc>
    <native_guid>CLARIION+APM00121202922+POOL+C+0004</native_guid>
    <assigned_varrays>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</assigned_varrays>
    <connected_varrays>urn:storageos:VirtualArray:f7c47391-87ec-4f10-b2d6-6d43e600610a:vdc1</connected_varrays>
    <tagged_varrays>urn:storageos:VirtualArray:44232490-75d6-4bec-b637-091e14cff7ec:vdc1</tagged_varrays>
    <compatibility_status>COMPATIBLE</compatibility_status>
    <controller_params/>
    <copy_types>
        <copy_type>UNSYNC_UNASSOC</copy_type>
        <copy_type>SYNC</copy_type>
        <copy_type>UNSYNC_ASSOC</copy_type>
    </copy_types>
    <drive_types>
        <drive_type>NL_SAS</drive_type>
    </drive_types>
    <free_gb>3046</free_gb>
    <max_pool_utilization_percentage>75</max_pool_utilization_percentage>
    <max_resources>-1</max_resources>
    <max_thin_pool_subscription_percentage>300</max_thin_pool_subscription_percentage>
    <maximum_thick_volume_size_gb>2979</maximum_thick_volume_size_gb>
    <maximum_thin_volume_size_gb>0</maximum_thin_volume_size_gb>
    <minimum_thick_volume_size_gb>0</minimum_thick_volume_size_gb>
    <minimum_thin_volume_size_gb>0</minimum_thin_volume_size_gb>
    <operational_status>READY</operational_status>
    <percent_subscribed>17</percent_subscribed>
    <percent_used>17</percent_used>
    <pool_name>0004</pool_name>
    <pool_service_type>block</pool_service_type>
    <protocols>
        <protocol>iSCSI</protocol>
        <protocol>FC</protocol>
    </protocols>
    <raid_levels>
        <raid_level>RAID6</raid_level>
    </raid_levels>
    <registration_status>REGISTERED</registration_status>
    <storage_system>
        <id>urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1</id>
        <link rel="self" href="/vdc/storage-systems/urn:storageos:StorageSystem:6460798a-9c6f-4b66-a7df-d01b39d270d1:vdc1"/>
    </storage_system>
    <subscribed_gb>618</subscribed_gb>
    <supported_resource_types>THICK_ONLY</supported_resource_types>
    <thin_volume_preallocation_supported>false</thin_volume_preallocation_supported>
    <tier_utilization_percentages/>
    <usable_gb>3664</usable_gb>
    <used_gb>618</used_gb>
</storage_pool>

ViPR 2.1 - Create and configure a ViPR virtual array using the ViPR REST API

Table of Contents

This article is part of a series

Before you begin

Procedure

Before you begin

Procedure

Procedure

Before you begin

Procedure

Procedure

Before you begin

Procedure