Product SiteDocumentation Site

13.4.  Storage Sub-Collection

The storage sub-collection provides a list of the iSCSI and FCP storage representations available on the host. This storage may be used to create storage domains, as described in Chapter 12, Storage Domains.
Each storage representation in the sub-collection represents either a SCSI LUN or an LVM volume group. A logical_unit representation contains:

Element property icons

The icons used in the properties column of this table are described in Table 8.1, “Element property icons”
Element Type Description Properties
id GUID An opaque identifier for the logical unit
address string The address of the iSCSI portal containing the LUN, in the case of iSCSI
port integer The port number of the iSCSI portal
target string The iSCSI target IQN
username string A CHAP user name for logging into an iSCSI target
password string A CHAP password for logging into an iSCSI target
A volume_group representation contains:
Element Type Description Properties
id GUID An opaque identifier for the volume group
name string An volume group name
logical_unit complex Details of any SCSI LUNs on which the volume group is based
Example 13.13. An XML representation of the storage sub-collection on a host
<host_storage>
    <storage id="82fb123b-321e-40a1-9889-95dcd2654463"
      href="/rhevm-api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/storage/
      82fb123b-321e-40a1-9889-95dcd2654463">
        <name>LUN0</name>
        <type>iscsi</type>
        <logical_unit id="LUN0">
            <address>mysan.example.com</address>
            <target>iqn.2009-08.com.example:mysan.foobar</target>
        </logical_unit>
    </storage>
    <storage id="f1d0ced5-d727-4217-8f2a-a514dff14bd5"
      href="/rhevm-api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/storage/
      f1d0ced5-d727-4217-8f2a-a514dff14bd5">
        <name>FooVG</name>
        <type>iscsi</type>
        <volume_group id="5432">
            <name>FooVG</name>
            <logical_unit id="LUN1">
                <address>mysan.example.com</address>
                <target>iqn.2009-08.com.example:mysan.foobar</target>
            </logical_unit>
            <logical_unit id="LUN2">
                <address>mysan.example.com</address>
                <target>iqn.2009-08.com.example:mysan.foobar</target>
            </logical_unit>
        </volume_group>
    </storage>
</host_storage>

Note

The host_storage collection is read-only.