com.amazonaws.services.inspector

Class AmazonInspectorClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.inspector.AmazonInspectorClient

All Implemented Interfaces:

AmazonInspector

Direct Known Subclasses:

AmazonInspectorAsyncClient

@ThreadSafe
public class AmazonInspectorClient
extends AmazonWebServiceClient
implements AmazonInspector

Client for accessing Amazon Inspector. All service calls made using this client are blocking, and will not return until the service call completes.

Amazon Inspector

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.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Constructor Summary

Constructors

Constructor and Description
AmazonInspectorClient() Constructs a new client to invoke service methods on Amazon Inspector.
AmazonInspectorClient(AWSCredentials awsCredentials) Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials.
AmazonInspectorClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration) Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials and client configuration options.
AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider) Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider.
AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration) Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider and client configuration options.
AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector) Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider, client configuration options, and request metric collector.
AmazonInspectorClient(ClientConfiguration clientConfiguration) Constructs a new client to invoke service methods on Amazon Inspector.

Method Summary

Methods

Modifier and Type	Method and Description
AddAttributesToFindingsResult	addAttributesToFindings(AddAttributesToFindingsRequest addAttributesToFindingsRequest) Assigns attributes (key and value pair) to the findings specified by the findings' ARNs.
CreateAssessmentTargetResult	createAssessmentTarget(CreateAssessmentTargetRequest createAssessmentTargetRequest) Creates a new assessment target using the resource group ARN generated by CreateResourceGroup.
CreateAssessmentTemplateResult	createAssessmentTemplate(CreateAssessmentTemplateRequest createAssessmentTemplateRequest) Creates an assessment template for the assessment target specified by the assessment target ARN.
CreateResourceGroupResult	createResourceGroup(CreateResourceGroupRequest createResourceGroupRequest) Creates 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 Inspector assessment target.
void	deleteAssessmentRun(DeleteAssessmentRunRequest deleteAssessmentRunRequest) Deletes the assessment run specified by the assessment run ARN.
void	deleteAssessmentTarget(DeleteAssessmentTargetRequest deleteAssessmentTargetRequest) Deletes the assessment target specified by the assessment target ARN.
void	deleteAssessmentTemplate(DeleteAssessmentTemplateRequest deleteAssessmentTemplateRequest) Deletes the assessment template specified by the assessment template ARN.
DescribeAssessmentRunsResult	describeAssessmentRuns(DescribeAssessmentRunsRequest describeAssessmentRunsRequest) Describes the assessment run(s) specified by the assessment run ARN(s).
DescribeAssessmentTargetsResult	describeAssessmentTargets(DescribeAssessmentTargetsRequest describeAssessmentTargetsRequest) Describes the assessment target(s) specified by the assessment target ARN(s).
DescribeAssessmentTemplatesResult	describeAssessmentTemplates(DescribeAssessmentTemplatesRequest describeAssessmentTemplatesRequest) Describes the assessment template(s) specified by the assessment template(s) ARN(s).
DescribeCrossAccountAccessRoleResult	describeCrossAccountAccessRole(DescribeCrossAccountAccessRoleRequest describeCrossAccountAccessRoleRequest) Describes the IAM role that enables Inspector to access your AWS account.
DescribeFindingsResult	describeFindings(DescribeFindingsRequest describeFindingsRequest) Describes the finding(s) specified by the finding ARN(s).
DescribeResourceGroupsResult	describeResourceGroups(DescribeResourceGroupsRequest describeResourceGroupsRequest) Describes resource group(s) specified by the resource group ARN(s).
DescribeRulesPackagesResult	describeRulesPackages(DescribeRulesPackagesRequest describeRulesPackagesRequest) Describes the rules package(s) specified by the rules package ARN(s).
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
GetTelemetryMetadataResult	getTelemetryMetadata(GetTelemetryMetadataRequest getTelemetryMetadataRequest) Information about the data collected for the specified assessment run.
ListAssessmentRunAgentsResult	listAssessmentRunAgents(ListAssessmentRunAgentsRequest listAssessmentRunAgentsRequest) Lists the agents of the assessment run specified by the assessment run ARN.
ListAssessmentRunsResult	listAssessmentRuns(ListAssessmentRunsRequest listAssessmentRunsRequest) Lists the assessments run corresponding to assessment template(s) specified by the assessment template(s)' ARN(s).
ListAssessmentTargetsResult	listAssessmentTargets(ListAssessmentTargetsRequest listAssessmentTargetsRequest) Lists the ARN(s) of the assessment target(s) within this AWS account.
ListAssessmentTemplatesResult	listAssessmentTemplates(ListAssessmentTemplatesRequest listAssessmentTemplatesRequest) Lists the assessment template(s) corresponding to the assessment target(s) specified by the assessment targets' ARN(s).
ListEventSubscriptionsResult	listEventSubscriptions(ListEventSubscriptionsRequest listEventSubscriptionsRequest) Lists all the event subscriptions for the assessment template specified by the assessment template ARN.
ListFindingsResult	listFindings(ListFindingsRequest listFindingsRequest) Lists findings generated by the assessment run(s) specified by the assessment run ARN(s).
ListRulesPackagesResult	listRulesPackages(ListRulesPackagesRequest listRulesPackagesRequest) Lists all available Inspector rules packages.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest) Lists all tags associated with an assessment template.
PreviewAgentsResult	previewAgents(PreviewAgentsRequest previewAgentsRequest) Previews the agents installed on the EC2 instances that are part of the specified assessment target.
void	registerCrossAccountAccessRole(RegisterCrossAccountAccessRoleRequest registerCrossAccountAccessRoleRequest) Registers the IAM role that Inspector uses to list your EC2 instances at the start of the assessment run or when you call the PreviewAgents action.
RemoveAttributesFromFindingsResult	removeAttributesFromFindings(RemoveAttributesFromFindingsRequest removeAttributesFromFindingsRequest) Removes entire attributes (key and value pairs) from the findings specified by the finding ARNs where an attribute with the specified key exists.
void	setTagsForResource(SetTagsForResourceRequest setTagsForResourceRequest) Sets tags (key and value pairs) to the assessment template specified by the assessment template ARN.
StartAssessmentRunResult	startAssessmentRun(StartAssessmentRunRequest startAssessmentRunRequest) Starts the assessment run specified by the assessment template ARN.
void	stopAssessmentRun(StopAssessmentRunRequest stopAssessmentRunRequest) Stops the assessment run specified by the assessment run ARN.
void	subscribeToEvent(SubscribeToEventRequest subscribeToEventRequest) Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified topic.
void	unsubscribeFromEvent(UnsubscribeFromEventRequest unsubscribeFromEventRequest) Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified topic.
void	updateAssessmentTarget(UpdateAssessmentTargetRequest updateAssessmentTargetRequest) Updates the assessment target specified by the assessment target ARN.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerRegionOverride, getTimeOffset, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.amazonaws.services.inspector.AmazonInspector

setEndpoint, setRegion, shutdown

Constructor Detail

AmazonInspectorClient

public AmazonInspectorClient()

Constructs a new client to invoke service methods on Amazon Inspector. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

See Also:

DefaultAWSCredentialsProviderChain

AmazonInspectorClient

public AmazonInspectorClient(ClientConfiguration clientConfiguration)

Constructs a new client to invoke service methods on Amazon Inspector. A credentials provider chain will be used that searches for credentials in this order:

• Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
• Java System Properties - aws.accessKeyId and aws.secretKey
• Instance profile credentials delivered through the Amazon EC2 metadata service

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

clientConfiguration - The client configuration options controlling how this client connects to Amazon Inspector (ex: proxy settings, retry counts, etc.).

See Also:

DefaultAWSCredentialsProviderChain

AmazonInspectorClient

public AmazonInspectorClient(AWSCredentials awsCredentials)

Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

AmazonInspectorClient

public AmazonInspectorClient(AWSCredentials awsCredentials,
                     ClientConfiguration clientConfiguration)

Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials and client configuration options.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentials - The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon Inspector (ex: proxy settings, retry counts, etc.).

AmazonInspectorClient

public AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider)

Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

AmazonInspectorClient

public AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider,
                     ClientConfiguration clientConfiguration)

Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider and client configuration options.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon Inspector (ex: proxy settings, retry counts, etc.).

AmazonInspectorClient

public AmazonInspectorClient(AWSCredentialsProvider awsCredentialsProvider,
                     ClientConfiguration clientConfiguration,
                     RequestMetricCollector requestMetricCollector)

Constructs a new client to invoke service methods on Amazon Inspector using the specified AWS account credentials provider, client configuration options, and request metric collector.

All service calls made using this new client object are blocking, and will not return until the service call completes.

Parameters:

awsCredentialsProvider - The AWS credentials provider which will provide credentials to authenticate requests with AWS services.

clientConfiguration - The client configuration options controlling how this client connects to Amazon Inspector (ex: proxy settings, retry counts, etc.).

requestMetricCollector - optional request metric collector

Method Detail

addAttributesToFindings

public AddAttributesToFindingsResult addAttributesToFindings(AddAttributesToFindingsRequest addAttributesToFindingsRequest)

Assigns attributes (key and value pair) to the findings specified by the findings' ARNs.

Specified by:

addAttributesToFindings in interface AmazonInspector

Parameters:

addAttributesToFindingsRequest -

Returns:

Result of the AddAttributesToFindings operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

createAssessmentTarget

public CreateAssessmentTargetResult createAssessmentTarget(CreateAssessmentTargetRequest createAssessmentTargetRequest)

Creates a new assessment target using the resource group ARN generated by CreateResourceGroup. You can create up to 50 assessment targets per AWS account. You can run up to 500 concurrent agents per AWS account. For more information, see Amazon Inspector Assessment Targets.

Specified by:

createAssessmentTarget in interface AmazonInspector

Parameters:

createAssessmentTargetRequest -

Returns:

Result of the CreateAssessmentTarget operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

LimitExceededException - The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

createAssessmentTemplate

public CreateAssessmentTemplateResult createAssessmentTemplate(CreateAssessmentTemplateRequest createAssessmentTemplateRequest)

Creates an assessment template for the assessment target specified by the assessment target ARN.

Specified by:

createAssessmentTemplate in interface AmazonInspector

Parameters:

createAssessmentTemplateRequest -

Returns:

Result of the CreateAssessmentTemplate operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

LimitExceededException - The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

createResourceGroup

public CreateResourceGroupResult createResourceGroup(CreateResourceGroupRequest createResourceGroupRequest)

Creates 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 Inspector assessment target. The created resource group is then used to create an Inspector assessment target.

Specified by:

createResourceGroup in interface AmazonInspector

Parameters:

createResourceGroupRequest -

Returns:

Result of the CreateResourceGroup operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

LimitExceededException - The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

AccessDeniedException - You do not have required permissions to access the requested resource.

deleteAssessmentRun

public void deleteAssessmentRun(DeleteAssessmentRunRequest deleteAssessmentRunRequest)

Deletes the assessment run specified by the assessment run ARN.

Specified by:

deleteAssessmentRun in interface AmazonInspector

Parameters:

deleteAssessmentRunRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AssessmentRunInProgressException - You cannot perform a specified action if an assessment run is currently in progress.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

deleteAssessmentTarget

public void deleteAssessmentTarget(DeleteAssessmentTargetRequest deleteAssessmentTargetRequest)

Deletes the assessment target specified by the assessment target ARN.

Specified by:

deleteAssessmentTarget in interface AmazonInspector

Parameters:

deleteAssessmentTargetRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AssessmentRunInProgressException - You cannot perform a specified action if an assessment run is currently in progress.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

deleteAssessmentTemplate

public void deleteAssessmentTemplate(DeleteAssessmentTemplateRequest deleteAssessmentTemplateRequest)

Deletes the assessment template specified by the assessment template ARN.

Specified by:

deleteAssessmentTemplate in interface AmazonInspector

Parameters:

deleteAssessmentTemplateRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AssessmentRunInProgressException - You cannot perform a specified action if an assessment run is currently in progress.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

describeAssessmentRuns

public DescribeAssessmentRunsResult describeAssessmentRuns(DescribeAssessmentRunsRequest describeAssessmentRunsRequest)

Describes the assessment run(s) specified by the assessment run ARN(s).

Specified by:

describeAssessmentRuns in interface AmazonInspector

Parameters:

describeAssessmentRunsRequest -

Returns:

Result of the DescribeAssessmentRuns operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

describeAssessmentTargets

public DescribeAssessmentTargetsResult describeAssessmentTargets(DescribeAssessmentTargetsRequest describeAssessmentTargetsRequest)

Describes the assessment target(s) specified by the assessment target ARN(s).

Specified by:

describeAssessmentTargets in interface AmazonInspector

Parameters:

describeAssessmentTargetsRequest -

Returns:

Result of the DescribeAssessmentTargets operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

describeAssessmentTemplates

public DescribeAssessmentTemplatesResult describeAssessmentTemplates(DescribeAssessmentTemplatesRequest describeAssessmentTemplatesRequest)

Describes the assessment template(s) specified by the assessment template(s) ARN(s).

Specified by:

describeAssessmentTemplates in interface AmazonInspector

Parameters:

describeAssessmentTemplatesRequest -

Returns:

Result of the DescribeAssessmentTemplates operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

describeCrossAccountAccessRole

public DescribeCrossAccountAccessRoleResult describeCrossAccountAccessRole(DescribeCrossAccountAccessRoleRequest describeCrossAccountAccessRoleRequest)

Describes the IAM role that enables Inspector to access your AWS account.

Specified by:

describeCrossAccountAccessRole in interface AmazonInspector

Parameters:

describeCrossAccountAccessRoleRequest -

Returns:

Result of the DescribeCrossAccountAccessRole operation returned by the service.

Throws:

InternalException - Internal server error.

describeFindings

public DescribeFindingsResult describeFindings(DescribeFindingsRequest describeFindingsRequest)

Describes the finding(s) specified by the finding ARN(s).

Specified by:

describeFindings in interface AmazonInspector

Parameters:

describeFindingsRequest -

Returns:

Result of the DescribeFindings operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

describeResourceGroups

public DescribeResourceGroupsResult describeResourceGroups(DescribeResourceGroupsRequest describeResourceGroupsRequest)

Describes resource group(s) specified by the resource group ARN(s).

Specified by:

describeResourceGroups in interface AmazonInspector

Parameters:

describeResourceGroupsRequest -

Returns:

Result of the DescribeResourceGroups operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

describeRulesPackages

public DescribeRulesPackagesResult describeRulesPackages(DescribeRulesPackagesRequest describeRulesPackagesRequest)

Describes the rules package(s) specified by the rules package ARN(s).

Specified by:

describeRulesPackages in interface AmazonInspector

Parameters:

describeRulesPackagesRequest -

Returns:

Result of the DescribeRulesPackages operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

getTelemetryMetadata

public GetTelemetryMetadataResult getTelemetryMetadata(GetTelemetryMetadataRequest getTelemetryMetadataRequest)

Information about the data collected for the specified assessment run.

Specified by:

getTelemetryMetadata in interface AmazonInspector

Parameters:

getTelemetryMetadataRequest -

Returns:

Result of the GetTelemetryMetadata operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listAssessmentRunAgents

public ListAssessmentRunAgentsResult listAssessmentRunAgents(ListAssessmentRunAgentsRequest listAssessmentRunAgentsRequest)

Lists the agents of the assessment run specified by the assessment run ARN.

Specified by:

listAssessmentRunAgents in interface AmazonInspector

Parameters:

listAssessmentRunAgentsRequest -

Returns:

Result of the ListAssessmentRunAgents operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listAssessmentRuns

public ListAssessmentRunsResult listAssessmentRuns(ListAssessmentRunsRequest listAssessmentRunsRequest)

Lists the assessments run corresponding to assessment template(s) specified by the assessment template(s)' ARN(s).

Specified by:

listAssessmentRuns in interface AmazonInspector

Parameters:

listAssessmentRunsRequest -

Returns:

Result of the ListAssessmentRuns operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listAssessmentTargets

public ListAssessmentTargetsResult listAssessmentTargets(ListAssessmentTargetsRequest listAssessmentTargetsRequest)

Lists the ARN(s) of the assessment target(s) within this AWS account. For more information about assessment targets, see Amazon Inspector Assessment Targets.

Specified by:

listAssessmentTargets in interface AmazonInspector

Parameters:

listAssessmentTargetsRequest -

Returns:

Result of the ListAssessmentTargets operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

listAssessmentTemplates

public ListAssessmentTemplatesResult listAssessmentTemplates(ListAssessmentTemplatesRequest listAssessmentTemplatesRequest)

Lists the assessment template(s) corresponding to the assessment target(s) specified by the assessment targets' ARN(s).

Specified by:

listAssessmentTemplates in interface AmazonInspector

Parameters:

listAssessmentTemplatesRequest -

Returns:

Result of the ListAssessmentTemplates operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listEventSubscriptions

public ListEventSubscriptionsResult listEventSubscriptions(ListEventSubscriptionsRequest listEventSubscriptionsRequest)

Lists all the event subscriptions for the assessment template specified by the assessment template ARN. For more information, see SubscribeToEvent and UnsubscribeFromEvent.

Specified by:

listEventSubscriptions in interface AmazonInspector

Parameters:

listEventSubscriptionsRequest -

Returns:

Result of the ListEventSubscriptions operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listFindings

public ListFindingsResult listFindings(ListFindingsRequest listFindingsRequest)

Lists findings generated by the assessment run(s) specified by the assessment run ARN(s).

Specified by:

listFindings in interface AmazonInspector

Parameters:

listFindingsRequest -

Returns:

Result of the ListFindings operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

listRulesPackages

public ListRulesPackagesResult listRulesPackages(ListRulesPackagesRequest listRulesPackagesRequest)

Lists all available Inspector rules packages.

Specified by:

listRulesPackages in interface AmazonInspector

Parameters:

listRulesPackagesRequest -

Returns:

Result of the ListRulesPackages operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

listTagsForResource

public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

Lists all tags associated with an assessment template.

Specified by:

listTagsForResource in interface AmazonInspector

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

previewAgents

public PreviewAgentsResult previewAgents(PreviewAgentsRequest previewAgentsRequest)

Previews the agents installed on the EC2 instances that are part of the specified assessment target.

Specified by:

previewAgents in interface AmazonInspector

Parameters:

previewAgentsRequest -

Returns:

Result of the PreviewAgents operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

InvalidCrossAccountRoleException - Inspector cannot assume the cross account role it needs to list your EC2 instances during the assessment run.

registerCrossAccountAccessRole

public void registerCrossAccountAccessRole(RegisterCrossAccountAccessRoleRequest registerCrossAccountAccessRoleRequest)

Registers the IAM role that Inspector uses to list your EC2 instances at the start of the assessment run or when you call the PreviewAgents action.

Specified by:

registerCrossAccountAccessRole in interface AmazonInspector

Parameters:

registerCrossAccountAccessRoleRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

InvalidCrossAccountRoleException - Inspector cannot assume the cross account role it needs to list your EC2 instances during the assessment run.

removeAttributesFromFindings

public RemoveAttributesFromFindingsResult removeAttributesFromFindings(RemoveAttributesFromFindingsRequest removeAttributesFromFindingsRequest)

Removes entire attributes (key and value pairs) from the findings specified by the finding ARNs where an attribute with the specified key exists.

Specified by:

removeAttributesFromFindings in interface AmazonInspector

Parameters:

removeAttributesFromFindingsRequest -

Returns:

Result of the RemoveAttributesFromFindings operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

setTagsForResource

public void setTagsForResource(SetTagsForResourceRequest setTagsForResourceRequest)

Sets tags (key and value pairs) to the assessment template specified by the assessment template ARN.

Specified by:

setTagsForResource in interface AmazonInspector

Parameters:

setTagsForResourceRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

startAssessmentRun

public StartAssessmentRunResult startAssessmentRun(StartAssessmentRunRequest startAssessmentRunRequest)

Starts the assessment run specified by the assessment template ARN. For this API to function properly, you must not exceed the limit of running up to 500 concurrent agents per AWS account.

Specified by:

startAssessmentRun in interface AmazonInspector

Parameters:

startAssessmentRunRequest -

Returns:

Result of the StartAssessmentRun operation returned by the service.

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

LimitExceededException - The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

InvalidCrossAccountRoleException - Inspector cannot assume the cross account role it needs to list your EC2 instances during the assessment run.

AgentsAlreadyRunningAssessmentException - You start an assessment run and one of the instances is already participating in another assessment run.

stopAssessmentRun

public void stopAssessmentRun(StopAssessmentRunRequest stopAssessmentRunRequest)

Stops the assessment run specified by the assessment run ARN.

Specified by:

stopAssessmentRun in interface AmazonInspector

Parameters:

stopAssessmentRunRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

subscribeToEvent

public void subscribeToEvent(SubscribeToEventRequest subscribeToEventRequest)

Enables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified topic.

Specified by:

subscribeToEvent in interface AmazonInspector

Parameters:

subscribeToEventRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

LimitExceededException - The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

unsubscribeFromEvent

public void unsubscribeFromEvent(UnsubscribeFromEventRequest unsubscribeFromEventRequest)

Disables the process of sending Amazon Simple Notification Service (SNS) notifications about a specified event to a specified topic.

Specified by:

unsubscribeFromEvent in interface AmazonInspector

Parameters:

unsubscribeFromEventRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

updateAssessmentTarget

public void updateAssessmentTarget(UpdateAssessmentTargetRequest updateAssessmentTargetRequest)

Updates the assessment target specified by the assessment target ARN.

Specified by:

updateAssessmentTarget in interface AmazonInspector

Parameters:

updateAssessmentTargetRequest -

Throws:

InternalException - Internal server error.

InvalidInputException - The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

AccessDeniedException - You do not have required permissions to access the requested resource.

NoSuchEntityException - The request was rejected because it referenced an entity that does not exist. The error code describes the entity.

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonInspector

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.