Skip to content

Get Finding V2

accessanalyzer_get_finding_v2 R Documentation

Retrieves information about the specified finding

Description

Retrieves information about the specified finding. GetFinding and GetFindingV2 both use access-analyzer:GetFinding in the Action element of an IAM policy statement. You must have permission to perform the access-analyzer:GetFinding action.

Usage

accessanalyzer_get_finding_v2(analyzerArn, id, maxResults, nextToken)

Arguments

analyzerArn

[required] The ARN of the analyzer that generated the finding.

id

[required] The ID of the finding to retrieve.

maxResults

The maximum number of results to return in the response.

nextToken

A token used for pagination of results returned.

Value

A list with the following syntax:

list(
  analyzedAt = as.POSIXct(
    "2015-01-01"
  ),
  createdAt = as.POSIXct(
    "2015-01-01"
  ),
  error = "string",
  id = "string",
  nextToken = "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"
  ),
  findingDetails = list(
    list(
      externalAccessDetails = list(
        action = list(
          "string"
        ),
        condition = list(
          "string"
        ),
        isPublic = TRUE|FALSE,
        principal = list(
          "string"
        ),
        sources = list(
          list(
            type = "POLICY"|"BUCKET_ACL"|"S3_ACCESS_POINT"|"S3_ACCESS_POINT_ACCOUNT",
            detail = list(
              accessPointArn = "string",
              accessPointAccount = "string"
            )
          )
        )
      ),
      unusedPermissionDetails = list(
        actions = list(
          list(
            action = "string",
            lastAccessed = as.POSIXct(
              "2015-01-01"
            )
          )
        ),
        serviceNamespace = "string",
        lastAccessed = as.POSIXct(
          "2015-01-01"
        )
      ),
      unusedIamUserAccessKeyDetails = list(
        accessKeyId = "string",
        lastAccessed = as.POSIXct(
          "2015-01-01"
        )
      ),
      unusedIamRoleDetails = list(
        lastAccessed = as.POSIXct(
          "2015-01-01"
        )
      ),
      unusedIamUserPasswordDetails = list(
        lastAccessed = as.POSIXct(
          "2015-01-01"
        )
      )
    )
  ),
  findingType = "ExternalAccess"|"UnusedIAMRole"|"UnusedIAMUserAccessKey"|"UnusedIAMUserPassword"|"UnusedPermission"
)

Request syntax

svc$get_finding_v2(
  analyzerArn = "string",
  id = "string",
  maxResults = 123,
  nextToken = "string"
)