Top System Query Option ($top)

The $top System Query Option is used to include in a response only the first N items of a resource collection.

For example, to return only the first three failover plans in the /FailoverPlans collection, send the following request:

VAO RESTful API returns resources in the default order based on its own semantics. To sort or filter a collection before selecting top results, use the $orderby or $filter query options. Note that the $orderby and  $filter options are applied before the $top option, regardless of their position in the request. That is, a collection is first filtered or ordered, and then the top results are selected.