Skip to content

List Findings

accessanalyzer_list_findings 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(analyzerArn, filter, sort, nextToken,
  maxResults)

Arguments

analyzerArn

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

filter

A filter to match for the findings to return.

sort

The sort order for the findings returned.

nextToken

A token used for pagination of results returned.

maxResults

The maximum number of results to return in the response.

Value

A list with the following syntax:

list(
  findings = list(
    list(
      id = "string",
      principal = list(
        "string"
      ),
      action = list(
        "string"
      ),
      resource = "string",
      isPublic = TRUE|FALSE,
      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",
      condition = list(
        "string"
      ),
      createdAt = as.POSIXct(
        "2015-01-01"
      ),
      analyzedAt = as.POSIXct(
        "2015-01-01"
      ),
      updatedAt = as.POSIXct(
        "2015-01-01"
      ),
      status = "ACTIVE"|"ARCHIVED"|"RESOLVED",
      resourceOwnerAccount = "string",
      error = "string",
      sources = list(
        list(
          type = "POLICY"|"BUCKET_ACL"|"S3_ACCESS_POINT"|"S3_ACCESS_POINT_ACCOUNT",
          detail = list(
            accessPointArn = "string",
            accessPointAccount = "string"
          )
        )
      )
    )
  ),
  nextToken = "string"
)

Request syntax

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