Skip to content

List Findings V2

accessanalyzer_list_findings_v2 R Documentation

Retrieves a list of findings generated by the specified analyzer

Description

Retrieves a list of findings generated by the specified analyzer. ListFindings and ListFindingsV2 both use access-analyzer:ListFindings in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:ListFindings action.

To learn about filter keys that you can use to retrieve a list of findings, see IAM Access Analyzer filter keys in the IAM User Guide.

Usage

accessanalyzer_list_findings_v2(analyzerArn, filter, maxResults,
  nextToken, sort)

Arguments

analyzerArn

[required] The ARN of the analyzer to retrieve findings from.

filter

A filter to match for the findings to return.

maxResults

The maximum number of results to return in the response.

nextToken

A token used for pagination of results returned.

sort

Value

A list with the following syntax:

list(
  findings = list(
    list(
      analyzedAt = as.POSIXct(
        "2015-01-01"
      ),
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      error = "string",
      id = "string",
      resource = "string",
      resourceType = "AWS::S3::Bucket"|"AWS::IAM::Role"|"AWS::SQS::Queue"|"AWS::Lambda::Function"|"AWS::Lambda::LayerVersion"|"AWS::KMS::Key"|"AWS::SecretsManager::Secret"|"AWS::EFS::FileSystem"|"AWS::EC2::Snapshot"|"AWS::ECR::Repository"|"AWS::RDS::DBSnapshot"|"AWS::RDS::DBClusterSnapshot"|"AWS::SNS::Topic"|"AWS::S3Express::DirectoryBucket"|"AWS::DynamoDB::Table"|"AWS::DynamoDB::Stream",
      resourceOwnerAccount = "string",
      status = "ACTIVE"|"ARCHIVED"|"RESOLVED",
      updatedAt = as.POSIXct(
        "2015-01-01"
      ),
      findingType = "ExternalAccess"|"UnusedIAMRole"|"UnusedIAMUserAccessKey"|"UnusedIAMUserPassword"|"UnusedPermission"
    )
  ),
  nextToken = "string"
)

Request syntax

svc$list_findings_v2(
  analyzerArn = "string",
  filter = list(
    list(
      eq = list(
        "string"
      ),
      neq = list(
        "string"
      ),
      contains = list(
        "string"
      ),
      exists = TRUE|FALSE
    )
  ),
  maxResults = 123,
  nextToken = "string",
  sort = list(
    attributeName = "string",
    orderBy = "ASC"|"DESC"
  )
)