Filtering

Filters accepts the full set of filter types supported by Query:

• Property filters — filter by a specific property value or component property value, with operators such as Equals, NotEquals, GreaterThan, GreaterThanOrEquals, LessThan, LessThanOrEquals, StartsWith, EndsWith, Contains, In. Supports an optional TypeId to target a component property, and an optional Uom for unit-aware comparisons.

• Relationship filters — filter by the targets of a named relationship.

• Range filters — filter resources whose property value falls between a MinValue and MaxValue, with options for inclusive or exclusive bounds, an optional Uom, and an optional tolerance. Like property filters, supports TypeId for component properties.

• Discovery filters — filter by structural characteristics of a resource rather than its values. Supported operations:

  • HasPropertyId — resource has a property with the given ID.

  • HasPropertyIdStartsWith — resource has a property whose ID begins with a prefix.

  • DoesNotHavePropertyId — resource lacks a property with the given ID.

  • HasComponent — resource has a component of the given type.

  • IsOrInheritsType — resource's type is, or inherits from, a specified type.

• ActiveBetween filters (events only) — filter events that were active (overlapping) during a specific time window defined by ActiveStartTime and ActiveEndTime.

Multiple filters are AND-ed together. Filters determine which resources are eligible for summarization; they do not affect grouping.

Time range filtering (events only)

StartsAfter and StartsBefore on the request provide a time-scoped window directly without needing to compose a property filter on StartTime. Both approaches work; you can also combine them.

SummarizeQueryEventsRequest {
StartsAfter: "2025-01-01T00:00:00Z", // inclusive
StartsBefore: "2025-02-01T00:00:00Z", // exclusive
...
}

Duration/active-event behavior (events only)

When summarizing a property that represents a TimeSpan (event duration), active (open-ended) events are excluded from the aggregation. An active event has no end time (or its end time is set to DateTime.MaxValue). Such an event still counts toward ResourceSummary.Count but does not contribute to PropertySummary.Count or any aggregate value.