Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1481826573.7 KB

Lists aggregated finding data for your environment based on specific criteria.

post/findings/aggregation/list

Request body

aggregationType'FINDING_TYPE' | 'PACKAGE' | 'TITLE' | 'REPOSITORY' | 'AMI' | 'AWS_EC2_INSTANCE' | 'AWS_ECR_CONTAINER' | 'IMAGE_LAYER' | 'ACCOUNT' | 'AWS_LAMBDA_FUNCTION' | 'LAMBDA_LAYER' | 'CODE_REPOSITORY' | 'VM_INSTANCE' | 'CONTAINER_IMAGE' | 'SERVERLESS_FUNCTION' required

The type of the aggregation request.

nextTokenstring

A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. If your response returns more than the <code>maxResults</code> maximum value it will also return a <code>nextToken</code> value. For subsequent calls, use the <code>nextToken</code> value returned from the previous request to continue listing results after the first page.

maxResultsinteger

The maximum number of results the response can return. If your request would return more than the maximum the response will return a <code>nextToken</code> value, use this value when you call the action again to get the remaining results.

Response

Success

aggregationType'FINDING_TYPE' | 'PACKAGE' | 'TITLE' | 'REPOSITORY' | 'AMI' | 'AWS_EC2_INSTANCE' | 'AWS_ECR_CONTAINER' | 'IMAGE_LAYER' | 'ACCOUNT' | 'AWS_LAMBDA_FUNCTION' | 'LAMBDA_LAYER' | 'CODE_REPOSITORY' | 'VM_INSTANCE' | 'CONTAINER_IMAGE' | 'SERVERLESS_FUNCTION' required

The type of aggregation to perform.

nextTokenstring

A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. For subsequent calls, use the <code>NextToken</code> value returned from the previous request to continue listing results after the first page.