This is an archive version of the document. To get the most up-to-date information, see the current version.

Filter System Query Option ($filter)

The $filter System Query Option is used to filter resource collections to return a subset of resources in a response. The subset includes only the resources that satisfy conditions specified in the query.

For example, to return a list of recovery locations for which the storage usage threshold is set to 80%, send the following request:

GET https://uwin2012r2.n.local:9899/v2/RecoveryLocations?$filter=storageUsageThreshold%20eq%20'80'

To get a representation of a recovery location with the specified ID, send the following request:

GET https://uwin2012r2.n.local:9899/v2/RecoveryLocations?$filter=id%20eq%20guid'76da0d75-75b0-4675-8296-0142ad0d52a7'

The $filter system query option supports a set of built-in filter operations and functions that can be used within these operations. For the full description of the syntax used for building requests, see the [OData-URL] syntax rule.