[This is preliminary documentation and is subject to change.]
The $expand operator enables inline expansion of collections contained within a resource. This functionality enables clients to pre-fetch multiple, related resources in a single server roundtrip. Using expansion, developers can traverse the references contained by the resource and retrieve their content inline.
The following example demonstrates the correct use of the $expand operator.
|
HTTP Request
|
GET https://user-ctp.windows.net/V0.1/Mesh/MeshObjects?$expand=Members,Mappings.Device |
|
Description
|
The server returns a collection of MeshObjects. For each MeshObject, Member and Mapping relationships are expanded and are returned inline. For each Mapping, the Devices/{deviceId} relationship is expanded and returned inline.
|