Files
developer.sailpoint.com/static/api-specs/idn/v3/paths/search-aggregate.yaml
2022-11-16 15:14:37 +00:00

59 lines
2.4 KiB
YAML

post:
tags:
- Search
description: >-
Performs a search query aggregation and returns aggregation result.
operationId: searchAggregate
summary: "Perform a Search Query Aggregation"
parameters:
- $ref: '../parameters/offset.yaml'
- $ref: '../parameters/limit.yaml'
- $ref: '../parameters/count.yaml'
requestBody:
content:
application/json:
schema:
$ref: '../schemas/search/Search.yaml'
examples:
metricAggregation:
$ref: '../schemas/search/aggregate/examples/metricAggregation.yaml'
metricAggregation-dsl:
$ref: '../schemas/search/aggregate/examples/metricAggregation-dsl.yaml'
bucketAggregation:
$ref: '../schemas/search/aggregate/examples/bucketAggregation.yaml'
bucketAggregation-dsl:
$ref: '../schemas/search/aggregate/examples/bucketAggregation-dsl.yaml'
nestedAggregation-bucketAggregation:
$ref: '../schemas/search/aggregate/examples/nestedAggregation-bucketAggregation.yaml'
nestedAggregation-bucketAggregation-dsl:
$ref: '../schemas/search/aggregate/examples/nestedAggregation-bucketAggregation-dsl.yaml'
nestedAggregation-filterAggregation-bucketAggregation:
$ref: '../schemas/search/aggregate/examples/nestedAggregation-filterAggregation-bucketAggregation.yaml'
nestedAggregation-filterAggregation-bucketAggregation-dsl:
$ref: '../schemas/search/aggregate/examples/nestedAggregation-filterAggregation-bucketAggregation-dsl.yaml'
bucketAggregation-subAggregation:
$ref: '../schemas/search/aggregate/examples/bucketAggregation-subAggregation.yaml'
bucketAggregation-subAggregation-dsl:
$ref: '../schemas/search/aggregate/examples/bucketAggregation-subAggregation-dsl.yaml'
required: true
responses:
'200':
description: Aggregation results.
content:
application/json:
schema:
$ref: '../schemas/search/documents/AggregationResult.yaml'
text/csv:
schema:
$ref: '../schemas/search/documents/AggregationResult-csv.yaml'
headers:
X-Total-Count:
description: The total result count (returned only if the *count* parameter is specified as *true*).
schema:
type: integer
example: 5
'400':
$ref: '../responses/400.yaml'
'403':
$ref: '../responses/403.yaml'