Error handling โ partial results
- Last UpdatedApr 14, 2026
- 1 minute read
SummarizeQuery returns partial results rather than failing the entire request when some properties cannot be summarized. Errors are reported in SummaryResponse.SummaryErrors alongside valid summaries.
SummaryError
message SummaryError {
ErrorCodes Code = 1;
string Title = 2; // short label for the error category
string Detail = 3; // human-readable explanation
optional string PropertyId = 4; // which property caused the error
optional string TypeId = 5; // which component, if applicable
string Resolution = 6;
optional int32 Count = 7; // how many resources encountered this error
map<string,string> Context = 8;
repeated ValidationError ValidationErrors = 9;
}
Common error scenarios
|
Scenario |
Result |
|---|---|
|
All requested properties are non-numeric |
No PropertySummary entries; SummaryErrors contains one error per property. |
|
Mixed numeric and non-numeric properties |
Valid properties return summaries; each invalid property gets a SummaryError. |
|
Some resource instances have a non-numeric value for an otherwise numeric property |
That instance is skipped (lowers PropertySummary.Count); a SummaryError is returned with Count indicating how many instances were skipped. |
|
Some resources fail authorization |
Those resources are excluded; an InsufficientAuthorization SummaryError is included. Metrics.UnauthorizedGroupCount reflects the number excluded. |
|
All resources fail authorization |
Summaries is empty; a single SummaryError is returned. |
When both authorization failures and non-numeric value errors occur in the same request, both error types appear in SummaryErrors.