Links and References
Resources sometimes need to refer to other resources. For example, to retrieve a list of all the virtual machines in a node one would need to submit a request to the resource GET /account/23/node/1/virtualmachine. Such a Uniform Resource Identifier (URI) refers to account resource /account/23 and node resource node/1. References can also occur within the body of requests or responses. For example, a request for the details of a virtual machine GET /virtualmachine/542 will result in a reply that has a body containing, among many other things, a reference to the OS template resource used by that virtual machine /ostemplate/3.