Learn R Programming

paws.security.identity (version 0.4.0)

inspector: Amazon Inspector

Description

Amazon Inspector enables you to analyze the behavior of your AWS resources and to identify potential security issues. For more information, see Amazon Inspector User Guide.

Usage

inspector(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

    • endpoint: The complete URL to use for the constructed client.

    • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Service syntax

svc <- inspector(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

add_attributes_to_findingsAssigns attributes (key and value pairs) to the findings that are specified by the ARNs of the findings
create_assessment_targetCreates a new assessment target using the ARN of the resource group that is generated by CreateResourceGroup
create_assessment_templateCreates an assessment template for the assessment target that is specified by the ARN of the assessment target
create_exclusions_previewStarts the generation of an exclusions preview for the specified assessment template
create_resource_groupCreates a resource group using the specified set of tags (key and value pairs) that are used to select the EC2 instances to be included in an Amazon Inspector assessment target
delete_assessment_runDeletes the assessment run that is specified by the ARN of the assessment run
delete_assessment_targetDeletes the assessment target that is specified by the ARN of the assessment target
delete_assessment_templateDeletes the assessment template that is specified by the ARN of the assessment template
describe_assessment_runsDescribes the assessment runs that are specified by the ARNs of the assessment runs
describe_assessment_targetsDescribes the assessment targets that are specified by the ARNs of the assessment targets
describe_assessment_templatesDescribes the assessment templates that are specified by the ARNs of the assessment templates
describe_cross_account_access_roleDescribes the IAM role that enables Amazon Inspector to access your AWS account
describe_exclusionsDescribes the exclusions that are specified by the exclusions' ARNs
describe_findingsDescribes the findings that are specified by the ARNs of the findings
describe_resource_groupsDescribes the resource groups that are specified by the ARNs of the resource groups
describe_rules_packagesDescribes the rules packages that are specified by the ARNs of the rules packages
get_assessment_reportProduces an assessment report that includes detailed and comprehensive results of a specified assessment run
get_exclusions_previewRetrieves the exclusions preview (a list of ExclusionPreview objects) specified by the preview token
get_telemetry_metadataInformation about the data that is collected for the specified assessment run
list_assessment_run_agentsLists the agents of the assessment runs that are specified by the ARNs of the assessment runs
list_assessment_runsLists the assessment runs that correspond to the assessment templates that are specified by the ARNs of the assessment templates
list_assessment_targetsLists the ARNs of the assessment targets within this AWS account
list_assessment_templatesLists the assessment templates that correspond to the assessment targets that are specified by the ARNs of the assessment targets
list_event_subscriptionsLists all the event subscriptions for the assessment template that is specified by the ARN of the assessment template
list_exclusionsList exclusions that are generated by the assessment run
list_findingsLists findings that are generated by the assessment runs that are specified by the ARNs of the assessment runs
list_rules_packagesLists all available Amazon Inspector rules packages
list_tags_for_resourceLists all tags associated with an assessment template
preview_agentsPreviews the agents installed on the EC2 instances that are part of the specified assessment target
register_cross_account_access_roleRegisters the IAM role that grants Amazon Inspector access to AWS Services needed to perform security assessments
remove_attributes_from_findingsRemoves entire attributes (key and value pairs) from the findings that are specified by the ARNs of the findings where an attribute with the specified key exists
set_tags_for_resourceSets tags (key and value pairs) to the assessment template that is specified by the ARN of the assessment template
start_assessment_runStarts the assessment run specified by the ARN of the assessment template
stop_assessment_runStops the assessment run that is specified by the ARN of the assessment run
subscribe_to_eventEnables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic
unsubscribe_from_eventDisables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified SNS topic
update_assessment_targetUpdates the assessment target that is specified by the ARN of the assessment target

Examples

Run this code
if (FALSE) {
svc <- inspector()
# Assigns attributes (key and value pairs) to the findings that are
# specified by the ARNs of the findings.
svc$add_attributes_to_findings(
  attributes = list(
    list(
      key = "Example",
      value = "example"
    )
  ),
  findingArns = list(
    "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-..."
  )
)
}

Run the code above in your browser using DataLab