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

Description¶

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

Usage¶

inspector2_list_finding_aggregations(aggregationType, nextToken,
  maxResults, accountIds, aggregationRequest)

Arguments¶

aggregationType

[required] The type of the aggregation request.
nextToken

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 maxResults maximum value it will also return a nextToken value. For subsequent calls, use the nextToken value returned from the previous request to continue listing results after the first page.
maxResults

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

The Amazon Web Services account IDs to retrieve finding aggregation data for.
aggregationRequest

Details of the aggregation request that is used to filter your aggregation results.

Value¶

A list with the following syntax:

list(
  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",
  responses = list(
    list(
      accountAggregation = list(
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        exploitAvailableCount = 123,
        fixAvailableCount = 123
      ),
      amiAggregation = list(
        ami = "string",
        accountId = "string",
        cloudProvider = "AWS"|"AZURE",
        cloudPartition = "string",
        cloudRegion = "string",
        cloudOrgId = "string",
        cloudAccountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        affectedInstances = 123
      ),
      awsEcrContainerAggregation = list(
        resourceId = "string",
        imageSha = "string",
        repository = "string",
        architecture = "string",
        imageTags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        lastInUseAt = as.POSIXct(
          "2015-01-01"
        ),
        inUseCount = 123
      ),
      ec2InstanceAggregation = list(
        instanceId = "string",
        ami = "string",
        operatingSystem = "string",
        instanceTags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        networkFindings = 123
      ),
      findingTypeAggregation = list(
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        exploitAvailableCount = 123,
        fixAvailableCount = 123,
        cloudProvider = "string",
        cloudAccountId = "string",
        cloudOrgId = "string",
        cloudRegion = "string",
        cloudPartition = "string"
      ),
      imageLayerAggregation = list(
        repository = "string",
        resourceId = "string",
        layerHash = "string",
        accountId = "string",
        cloudProvider = "string",
        cloudAccountId = "string",
        cloudOrgId = "string",
        cloudRegion = "string",
        cloudPartition = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        )
      ),
      packageAggregation = list(
        packageName = "string",
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        )
      ),
      repositoryAggregation = list(
        repository = "string",
        accountId = "string",
        cloudProvider = "AWS"|"AZURE",
        cloudPartition = "string",
        cloudRegion = "string",
        cloudOrgId = "string",
        cloudAccountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        affectedImages = 123
      ),
      titleAggregation = list(
        title = "string",
        vulnerabilityId = "string",
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        )
      ),
      lambdaLayerAggregation = list(
        functionName = "string",
        resourceId = "string",
        layerArn = "string",
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        )
      ),
      lambdaFunctionAggregation = list(
        resourceId = "string",
        functionName = "string",
        runtime = "string",
        lambdaTags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        lastModifiedAt = as.POSIXct(
          "2015-01-01"
        )
      ),
      codeRepositoryAggregation = list(
        projectNames = "string",
        providerType = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        exploitAvailableActiveFindingsCount = 123,
        fixAvailableActiveFindingsCount = 123,
        accountId = "string",
        resourceId = "string"
      ),
      vmInstanceAggregation = list(
        resourceId = "string",
        cloudProvider = "AWS"|"AZURE",
        cloudAccountId = "string",
        cloudPartition = "string",
        cloudRegion = "string",
        cloudOrgId = "string",
        vmImageReference = "string",
        operatingSystem = "string",
        tags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        networkFindings = 123,
        exploitAvailableActiveFindingsCount = 123,
        fixAvailableActiveFindingsCount = 123
      ),
      containerImageAggregation = list(
        resourceId = "string",
        cloudProvider = "AWS"|"AZURE",
        cloudAccountId = "string",
        cloudPartition = "string",
        cloudRegion = "string",
        cloudOrgId = "string",
        imageDigest = "string",
        repository = "string",
        registry = "string",
        architecture = "string",
        imageTags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        lastInUseAt = as.POSIXct(
          "2015-01-01"
        ),
        inUseCount = 123,
        exploitAvailableActiveFindingsCount = 123,
        fixAvailableActiveFindingsCount = 123
      ),
      serverlessFunctionAggregation = list(
        resourceId = "string",
        cloudProvider = "AWS"|"AZURE",
        cloudAccountId = "string",
        cloudPartition = "string",
        cloudRegion = "string",
        cloudOrgId = "string",
        functionName = "string",
        runtime = "string",
        tags = list(
          "string"
        ),
        accountId = "string",
        severityCounts = list(
          all = 123,
          medium = 123,
          high = 123,
          critical = 123,
          low = 123,
          informational = 123,
          untriaged = 123
        ),
        lastModifiedAt = as.POSIXct(
          "2015-01-01"
        ),
        exploitAvailableActiveFindingsCount = 123,
        fixAvailableActiveFindingsCount = 123
      )
    )
  ),
  nextToken = "string"
)

Request syntax¶

svc$list_finding_aggregations(
  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",
  nextToken = "string",
  maxResults = 123,
  accountIds = list(
    list(
      comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
      value = "string"
    )
  ),
  aggregationRequest = list(
    accountAggregation = list(
      findingType = "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
      resourceType = "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION"|"CODE_REPOSITORY"|"Microsoft.Compute/virtualMachines"|"Microsoft.ContainerRegistry/registry/containerImage"|"Microsoft.Web/sites",
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    amiAggregation = list(
      amis = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"|"AFFECTED_INSTANCES"
    ),
    awsEcrContainerAggregation = list(
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      imageShas = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      repositories = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      architectures = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      imageTags = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL",
      lastInUseAt = list(
        list(
          startInclusive = as.POSIXct(
            "2015-01-01"
          ),
          endInclusive = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      inUseCount = list(
        list(
          upperInclusive = 123.0,
          lowerInclusive = 123.0
        )
      )
    ),
    ec2InstanceAggregation = list(
      amis = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      operatingSystems = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      instanceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      instanceTags = list(
        list(
          comparison = "EQUALS",
          key = "string",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "NETWORK_FINDINGS"|"CRITICAL"|"HIGH"|"ALL"
    ),
    findingTypeAggregation = list(
      findingType = "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
      resourceType = "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION"|"CODE_REPOSITORY"|"Microsoft.Compute/virtualMachines"|"Microsoft.ContainerRegistry/registry/containerImage"|"Microsoft.Web/sites",
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    imageLayerAggregation = list(
      repositories = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      layerHashes = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudProviders = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudAccountIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudOrgIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudRegions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudPartitions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    packageAggregation = list(
      packageNames = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    repositoryAggregation = list(
      repositories = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"|"AFFECTED_IMAGES"
    ),
    titleAggregation = list(
      titles = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      vulnerabilityIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      resourceType = "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION"|"CODE_REPOSITORY"|"Microsoft.Compute/virtualMachines"|"Microsoft.ContainerRegistry/registry/containerImage"|"Microsoft.Web/sites",
      findingType = "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    lambdaLayerAggregation = list(
      functionNames = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      layerArns = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    lambdaFunctionAggregation = list(
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      functionNames = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      runtimes = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      functionTags = list(
        list(
          comparison = "EQUALS",
          key = "string",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    codeRepositoryAggregation = list(
      projectNames = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      providerTypes = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL",
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      )
    ),
    vmInstanceAggregation = list(
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      operatingSystems = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      instanceTags = list(
        list(
          comparison = "EQUALS",
          key = "string",
          value = "string"
        )
      ),
      vmImageReferences = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudProviders = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudPartitions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudRegions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudOrgIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudAccountIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"|"NETWORK_FINDINGS"
    ),
    containerImageAggregation = list(
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      imageDigests = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      repositories = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      registries = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      architectures = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      imageTags = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudProviders = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudPartitions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudRegions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudOrgIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudAccountIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      lastInUseAt = list(
        list(
          startInclusive = as.POSIXct(
            "2015-01-01"
          ),
          endInclusive = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      inUseCount = list(
        list(
          upperInclusive = 123.0,
          lowerInclusive = 123.0
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    ),
    serverlessFunctionAggregation = list(
      resourceIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      functionNames = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      runtimes = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      functionTags = list(
        list(
          comparison = "EQUALS",
          key = "string",
          value = "string"
        )
      ),
      cloudProviders = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudPartitions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudRegions = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudOrgIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      cloudAccountIds = list(
        list(
          comparison = "EQUALS"|"PREFIX"|"NOT_EQUALS",
          value = "string"
        )
      ),
      sortOrder = "ASC"|"DESC",
      sortBy = "CRITICAL"|"HIGH"|"ALL"
    )
  )
)