References
----------

References in the system represent the reference of an entity in the system as `Hypermedia as the Engine of Application State <http://en.wikipedia.org/wiki/HATEOAS>`_ (HATEOS).  Each reference position is represented by an object pair pkid and href.

* **device**: A list of one device that relates the resource to a device resource in the system.
* **owner**: The owner reference would exist if the current resource was created by a Domain Model (feature model)
* **self**: A list of containing a reference to the current resource.
* **parent** (reserved for hierarchy): An entry containing the parent in the hierarchy: zero for root node, one for other resources.
* **children** (reserved for hierarchy): A list of zero or more children in the hierarchy tree below the resource.


For example:

.. .. sourcecode:: json

.. parsed-literal::

    "references": {
        "device": [{
            "pkid": "",
            "href": ""
        }],
        "owner": [{
            "pkid": "",
            "href": ""
        }],
        "self": [{
            "pkid": "5135fc0f31790a3000a83b2b",
            "href": "/api/data/CallManager/5135fc0f31790a3000a83b2b"
        }],
        "children": [],
        "parent": [{
            "pkid": "5135fb8331790a2ffee7d7ab",
            "href": "/api/data/HierarchyNode/5135fb8331790a2ffee7d7ab"
        }]
    }



.. |VOSS-4-UC| replace:: VOSS-4-UC
.. |Unified CM| replace:: Unified CM