Skip to content

Returns a list of image scan aggregations for your account

Description

Returns a list of image scan aggregations for your account. You can filter by the type of key that Image Builder uses to group results. For example, if you want to get a list of findings by severity level for one of your pipelines, you might specify your pipeline with the imagePipelineArn filter. If you don't specify a filter, Image Builder returns an aggregation for your account.

To streamline results, you can use the following filters in your request:

  • imageBuildVersionArn
  • imagePipelineArn
  • vulnerabilityId

Usage

imagebuilder_list_image_scan_finding_aggregations(filter, nextToken)

Arguments

  • filter

    A filter name and value pair that determines the type of aggregation that Image Builder returns. Use one of the following filter names:

    • imageBuildVersionArn
    • imagePipelineArn
    • vulnerabilityId

    If you don't specify a filter, Image Builder returns an aggregation for your account.

  • nextToken

    A token to specify where to start paginating. Use the nextToken value from a previously truncated response.

Value

A list with the following syntax:

list(
  requestId = "string",
  aggregationType = "string",
  responses = list(
    list(
      accountAggregation = list(
        accountId = "string",
        severityCounts = list(
          all = 123,
          critical = 123,
          high = 123,
          medium = 123
        )
      ),
      imageAggregation = list(
        imageBuildVersionArn = "string",
        severityCounts = list(
          all = 123,
          critical = 123,
          high = 123,
          medium = 123
        )
      ),
      imagePipelineAggregation = list(
        imagePipelineArn = "string",
        severityCounts = list(
          all = 123,
          critical = 123,
          high = 123,
          medium = 123
        )
      ),
      vulnerabilityIdAggregation = list(
        vulnerabilityId = "string",
        severityCounts = list(
          all = 123,
          critical = 123,
          high = 123,
          medium = 123
        )
      )
    )
  ),
  nextToken = "string"
)

Request syntax

svc$list_image_scan_finding_aggregations(
  filter = list(
    name = "string",
    values = list(
      "string"
    )
  ),
  nextToken = "string"
)