All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.guardduty.AmazonGuardDuty Maven / Gradle / Ivy

Go to download

The AWS Java SDK for Amazon GuardDuty module holds the client classes that are used for communicating with Amazon GuardDuty Service

There is a newer version: 1.12.780
Show newest version
/*
 * Copyright 2014-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
 * the License. A copy of the License is located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
 * and limitations under the License.
 */
package com.amazonaws.services.guardduty;

import javax.annotation.Generated;

import com.amazonaws.*;
import com.amazonaws.regions.*;

import com.amazonaws.services.guardduty.model.*;

/**
 * Interface for accessing Amazon GuardDuty.
 * 

* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.guardduty.AbstractAmazonGuardDuty} instead. *

*

*

* Amazon GuardDuty is a continuous security monitoring service that analyzes and processes the following data sources: * VPC Flow Logs, AWS CloudTrail event logs, and DNS logs. It uses threat intelligence feeds, such as lists of malicious * IPs and domains, and machine learning to identify unexpected and potentially unauthorized and malicious activity * within your AWS environment. This can include issues like escalations of privileges, uses of exposed credentials, or * communication with malicious IPs, URLs, or domains. For example, GuardDuty can detect compromised EC2 instances * serving malware or mining bitcoin. It also monitors AWS account access behavior for signs of compromise, such as * unauthorized infrastructure deployments, like instances deployed in a region that has never been used, or unusual API * calls, like a password policy change to reduce password strength. GuardDuty informs you of the status of your AWS * environment by producing security findings that you can view in the GuardDuty console or through Amazon CloudWatch * events. For more information, see * Amazon GuardDuty User Guide. *

*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonGuardDuty { /** * The region metadata service name for computing region endpoints. You can use this value to retrieve metadata * (such as supported regions) of the service. * * @see RegionUtils#getRegionsForService(String) */ String ENDPOINT_PREFIX = "guardduty"; /** *

* Accepts the invitation to be monitored by a master GuardDuty account. *

* * @param acceptInvitationRequest * @return Result of the AcceptInvitation operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.AcceptInvitation * @see AWS API * Documentation */ AcceptInvitationResult acceptInvitation(AcceptInvitationRequest acceptInvitationRequest); /** *

* Archives GuardDuty findings specified by the list of finding IDs. *

* *

* Only the master account can archive findings. Member accounts do not have permission to archive findings from * their accounts. *

*
* * @param archiveFindingsRequest * @return Result of the ArchiveFindings operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ArchiveFindings * @see AWS API * Documentation */ ArchiveFindingsResult archiveFindings(ArchiveFindingsRequest archiveFindingsRequest); /** *

* Creates a single Amazon GuardDuty detector. A detector is a resource that represents the GuardDuty service. To * start using GuardDuty, you must create a detector in each region that you enable the service. You can have only * one detector per account per region. *

* * @param createDetectorRequest * @return Result of the CreateDetector operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateDetector * @see AWS API * Documentation */ CreateDetectorResult createDetector(CreateDetectorRequest createDetectorRequest); /** *

* Creates a filter using the specified finding criteria. *

* * @param createFilterRequest * @return Result of the CreateFilter operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateFilter * @see AWS API * Documentation */ CreateFilterResult createFilter(CreateFilterRequest createFilterRequest); /** *

* Creates a new IPSet - a list of trusted IP addresses that have been whitelisted for secure communication with AWS * infrastructure and applications. *

* * @param createIPSetRequest * @return Result of the CreateIPSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateIPSet * @see AWS API * Documentation */ CreateIPSetResult createIPSet(CreateIPSetRequest createIPSetRequest); /** *

* Creates member accounts of the current AWS account by specifying a list of AWS account IDs. The current AWS * account can then invite these members to manage GuardDuty in their accounts. *

* * @param createMembersRequest * @return Result of the CreateMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateMembers * @see AWS API * Documentation */ CreateMembersResult createMembers(CreateMembersRequest createMembersRequest); /** *

* Generates example findings of types specified by the list of finding types. If 'NULL' is specified for * findingTypes, the API generates example findings of all supported finding types. *

* * @param createSampleFindingsRequest * @return Result of the CreateSampleFindings operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateSampleFindings * @see AWS * API Documentation */ CreateSampleFindingsResult createSampleFindings(CreateSampleFindingsRequest createSampleFindingsRequest); /** *

* Create a new ThreatIntelSet. ThreatIntelSets consist of known malicious IP addresses. GuardDuty generates * findings based on ThreatIntelSets. *

* * @param createThreatIntelSetRequest * @return Result of the CreateThreatIntelSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.CreateThreatIntelSet * @see AWS * API Documentation */ CreateThreatIntelSetResult createThreatIntelSet(CreateThreatIntelSetRequest createThreatIntelSetRequest); /** *

* Declines invitations sent to the current member account by AWS account specified by their account IDs. *

* * @param declineInvitationsRequest * @return Result of the DeclineInvitations operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeclineInvitations * @see AWS * API Documentation */ DeclineInvitationsResult declineInvitations(DeclineInvitationsRequest declineInvitationsRequest); /** *

* Deletes a Amazon GuardDuty detector specified by the detector ID. *

* * @param deleteDetectorRequest * @return Result of the DeleteDetector operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteDetector * @see AWS API * Documentation */ DeleteDetectorResult deleteDetector(DeleteDetectorRequest deleteDetectorRequest); /** *

* Deletes the filter specified by the filter name. *

* * @param deleteFilterRequest * @return Result of the DeleteFilter operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteFilter * @see AWS API * Documentation */ DeleteFilterResult deleteFilter(DeleteFilterRequest deleteFilterRequest); /** *

* Deletes the IPSet specified by the IPSet ID. *

* * @param deleteIPSetRequest * @return Result of the DeleteIPSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteIPSet * @see AWS API * Documentation */ DeleteIPSetResult deleteIPSet(DeleteIPSetRequest deleteIPSetRequest); /** *

* Deletes invitations sent to the current member account by AWS accounts specified by their account IDs. *

* * @param deleteInvitationsRequest * @return Result of the DeleteInvitations operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteInvitations * @see AWS * API Documentation */ DeleteInvitationsResult deleteInvitations(DeleteInvitationsRequest deleteInvitationsRequest); /** *

* Deletes GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs. *

* * @param deleteMembersRequest * @return Result of the DeleteMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteMembers * @see AWS API * Documentation */ DeleteMembersResult deleteMembers(DeleteMembersRequest deleteMembersRequest); /** *

* Deletes ThreatIntelSet specified by the ThreatIntelSet ID. *

* * @param deleteThreatIntelSetRequest * @return Result of the DeleteThreatIntelSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DeleteThreatIntelSet * @see AWS * API Documentation */ DeleteThreatIntelSetResult deleteThreatIntelSet(DeleteThreatIntelSetRequest deleteThreatIntelSetRequest); /** *

* Disassociates the current GuardDuty member account from its master account. *

* * @param disassociateFromMasterAccountRequest * @return Result of the DisassociateFromMasterAccount operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DisassociateFromMasterAccount * @see AWS API Documentation */ DisassociateFromMasterAccountResult disassociateFromMasterAccount(DisassociateFromMasterAccountRequest disassociateFromMasterAccountRequest); /** *

* Disassociates GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs. *

* * @param disassociateMembersRequest * @return Result of the DisassociateMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.DisassociateMembers * @see AWS * API Documentation */ DisassociateMembersResult disassociateMembers(DisassociateMembersRequest disassociateMembersRequest); /** *

* Retrieves an Amazon GuardDuty detector specified by the detectorId. *

* * @param getDetectorRequest * @return Result of the GetDetector operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetDetector * @see AWS API * Documentation */ GetDetectorResult getDetector(GetDetectorRequest getDetectorRequest); /** *

* Returns the details of the filter specified by the filter name. *

* * @param getFilterRequest * @return Result of the GetFilter operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetFilter * @see AWS API * Documentation */ GetFilterResult getFilter(GetFilterRequest getFilterRequest); /** *

* Describes Amazon GuardDuty findings specified by finding IDs. *

* * @param getFindingsRequest * @return Result of the GetFindings operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetFindings * @see AWS API * Documentation */ GetFindingsResult getFindings(GetFindingsRequest getFindingsRequest); /** *

* Lists Amazon GuardDuty findings' statistics for the specified detector ID. *

* * @param getFindingsStatisticsRequest * @return Result of the GetFindingsStatistics operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetFindingsStatistics * @see AWS API Documentation */ GetFindingsStatisticsResult getFindingsStatistics(GetFindingsStatisticsRequest getFindingsStatisticsRequest); /** *

* Retrieves the IPSet specified by the IPSet ID. *

* * @param getIPSetRequest * @return Result of the GetIPSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetIPSet * @see AWS API * Documentation */ GetIPSetResult getIPSet(GetIPSetRequest getIPSetRequest); /** *

* Returns the count of all GuardDuty membership invitations that were sent to the current member account except the * currently accepted invitation. *

* * @param getInvitationsCountRequest * @return Result of the GetInvitationsCount operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetInvitationsCount * @see AWS * API Documentation */ GetInvitationsCountResult getInvitationsCount(GetInvitationsCountRequest getInvitationsCountRequest); /** *

* Provides the details for the GuardDuty master account associated with the current GuardDuty member account. *

* * @param getMasterAccountRequest * @return Result of the GetMasterAccount operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetMasterAccount * @see AWS API * Documentation */ GetMasterAccountResult getMasterAccount(GetMasterAccountRequest getMasterAccountRequest); /** *

* Retrieves GuardDuty member accounts (to the current GuardDuty master account) specified by the account IDs. *

* * @param getMembersRequest * @return Result of the GetMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetMembers * @see AWS API * Documentation */ GetMembersResult getMembers(GetMembersRequest getMembersRequest); /** *

* Retrieves the ThreatIntelSet that is specified by the ThreatIntelSet ID. *

* * @param getThreatIntelSetRequest * @return Result of the GetThreatIntelSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.GetThreatIntelSet * @see AWS * API Documentation */ GetThreatIntelSetResult getThreatIntelSet(GetThreatIntelSetRequest getThreatIntelSetRequest); /** *

* Invites other AWS accounts (created as members of the current AWS account by CreateMembers) to enable GuardDuty * and allow the current AWS account to view and manage these accounts' GuardDuty findings on their behalf as the * master account. *

* * @param inviteMembersRequest * @return Result of the InviteMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.InviteMembers * @see AWS API * Documentation */ InviteMembersResult inviteMembers(InviteMembersRequest inviteMembersRequest); /** *

* Lists detectorIds of all the existing Amazon GuardDuty detector resources. *

* * @param listDetectorsRequest * @return Result of the ListDetectors operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListDetectors * @see AWS API * Documentation */ ListDetectorsResult listDetectors(ListDetectorsRequest listDetectorsRequest); /** *

* Returns a paginated list of the current filters. *

* * @param listFiltersRequest * @return Result of the ListFilters operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListFilters * @see AWS API * Documentation */ ListFiltersResult listFilters(ListFiltersRequest listFiltersRequest); /** *

* Lists Amazon GuardDuty findings for the specified detector ID. *

* * @param listFindingsRequest * @return Result of the ListFindings operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListFindings * @see AWS API * Documentation */ ListFindingsResult listFindings(ListFindingsRequest listFindingsRequest); /** *

* Lists the IPSets of the GuardDuty service specified by the detector ID. *

* * @param listIPSetsRequest * @return Result of the ListIPSets operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListIPSets * @see AWS API * Documentation */ ListIPSetsResult listIPSets(ListIPSetsRequest listIPSetsRequest); /** *

* Lists all GuardDuty membership invitations that were sent to the current AWS account. *

* * @param listInvitationsRequest * @return Result of the ListInvitations operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListInvitations * @see AWS API * Documentation */ ListInvitationsResult listInvitations(ListInvitationsRequest listInvitationsRequest); /** *

* Lists details about all member accounts for the current GuardDuty master account. *

* * @param listMembersRequest * @return Result of the ListMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListMembers * @see AWS API * Documentation */ ListMembersResult listMembers(ListMembersRequest listMembersRequest); /** *

* Lists tags for a resource. Tagging is currently supported for detectors, finding filters, IP sets, and Threat * Intel sets, with a limit of 50 tags per resource. When invoked, this operation returns all assigned tags for a * given resource.. *

* * @param listTagsForResourceRequest * @return Result of the ListTagsForResource operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListTagsForResource * @see AWS * API Documentation */ ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest); /** *

* Lists the ThreatIntelSets of the GuardDuty service specified by the detector ID. *

* * @param listThreatIntelSetsRequest * @return Result of the ListThreatIntelSets operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.ListThreatIntelSets * @see AWS * API Documentation */ ListThreatIntelSetsResult listThreatIntelSets(ListThreatIntelSetsRequest listThreatIntelSetsRequest); /** *

* Re-enables GuardDuty to monitor findings of the member accounts specified by the account IDs. A master GuardDuty * account can run this command after disabling GuardDuty from monitoring these members' findings by running * StopMonitoringMembers. *

* * @param startMonitoringMembersRequest * @return Result of the StartMonitoringMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.StartMonitoringMembers * @see AWS API Documentation */ StartMonitoringMembersResult startMonitoringMembers(StartMonitoringMembersRequest startMonitoringMembersRequest); /** *

* Disables GuardDuty from monitoring findings of the member accounts specified by the account IDs. After running * this command, a master GuardDuty account can run StartMonitoringMembers to re-enable GuardDuty to monitor these * members’ findings. *

* * @param stopMonitoringMembersRequest * @return Result of the StopMonitoringMembers operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.StopMonitoringMembers * @see AWS API Documentation */ StopMonitoringMembersResult stopMonitoringMembers(StopMonitoringMembersRequest stopMonitoringMembersRequest); /** *

* Adds tags to a resource. *

* * @param tagResourceRequest * @return Result of the TagResource operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.TagResource * @see AWS API * Documentation */ TagResourceResult tagResource(TagResourceRequest tagResourceRequest); /** *

* Unarchives Amazon GuardDuty findings specified by the list of finding IDs. *

* * @param unarchiveFindingsRequest * @return Result of the UnarchiveFindings operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UnarchiveFindings * @see AWS * API Documentation */ UnarchiveFindingsResult unarchiveFindings(UnarchiveFindingsRequest unarchiveFindingsRequest); /** *

* Removes tags from a resource. *

* * @param untagResourceRequest * @return Result of the UntagResource operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UntagResource * @see AWS API * Documentation */ UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest); /** *

* Updates an Amazon GuardDuty detector specified by the detectorId. *

* * @param updateDetectorRequest * @return Result of the UpdateDetector operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UpdateDetector * @see AWS API * Documentation */ UpdateDetectorResult updateDetector(UpdateDetectorRequest updateDetectorRequest); /** *

* Updates the filter specified by the filter name. *

* * @param updateFilterRequest * @return Result of the UpdateFilter operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UpdateFilter * @see AWS API * Documentation */ UpdateFilterResult updateFilter(UpdateFilterRequest updateFilterRequest); /** *

* Marks specified Amazon GuardDuty findings as useful or not useful. *

* * @param updateFindingsFeedbackRequest * @return Result of the UpdateFindingsFeedback operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UpdateFindingsFeedback * @see AWS API Documentation */ UpdateFindingsFeedbackResult updateFindingsFeedback(UpdateFindingsFeedbackRequest updateFindingsFeedbackRequest); /** *

* Updates the IPSet specified by the IPSet ID. *

* * @param updateIPSetRequest * @return Result of the UpdateIPSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UpdateIPSet * @see AWS API * Documentation */ UpdateIPSetResult updateIPSet(UpdateIPSetRequest updateIPSetRequest); /** *

* Updates the ThreatIntelSet specified by ThreatIntelSet ID. *

* * @param updateThreatIntelSetRequest * @return Result of the UpdateThreatIntelSet operation returned by the service. * @throws BadRequestException * Bad request exception object. * @throws InternalServerErrorException * Internal server error exception object. * @sample AmazonGuardDuty.UpdateThreatIntelSet * @see AWS * API Documentation */ UpdateThreatIntelSetResult updateThreatIntelSet(UpdateThreatIntelSetRequest updateThreatIntelSetRequest); /** * Shuts down this client object, releasing any resources that might be held open. This is an optional method, and * callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client * has been shutdown, it should not be used to make any more requests. */ void shutdown(); /** * 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 a request. * * @param request * The originally executed request. * * @return The response metadata for the specified request, or null if none is available. */ ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request); }





© 2015 - 2025 Weber Informatics LLC | Privacy Policy