NAME

Paws::SecurityHub - Perl Interface to AWS AWS SecurityHub

SYNOPSIS

  use Paws;

  my $obj = Paws->service('SecurityHub');
  my $res = $obj->Method(
    Arg1 => $val1,
    Arg2 => [ 'V1', 'V2' ],
    # if Arg3 is an object, the HashRef will be used as arguments to the constructor
    # of the arguments type
    Arg3 => { Att1 => 'Val1' },
    # if Arg4 is an array of objects, the HashRefs will be passed as arguments to
    # the constructor of the arguments type
    Arg4 => [ { Att1 => 'Val1'  }, { Att1 => 'Val2' } ],
  );

DESCRIPTION

AWS Security Hub provides you with a comprehensive view of your security state within AWS and your compliance with the security industry standards and best practices. Security Hub collects security data from across AWS accounts, services, and supported third-party partners and helps you analyze your security trends and identify the highest priority security issues. For more information, see AWS Security Hub User Guide.

For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26

METHODS

AcceptInvitation

[InvitationId => Str]
[MasterId => Str]

Each argument is described in detail in: Paws::SecurityHub::AcceptInvitation

Returns: a Paws::SecurityHub::AcceptInvitationResponse instance

Accepts the invitation to be monitored by a master SecurityHub account.

BatchDisableStandards

StandardsSubscriptionArns => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::SecurityHub::BatchDisableStandards

Returns: a Paws::SecurityHub::BatchDisableStandardsResponse instance

Disables the standards specified by the standards subscription ARNs. In the context of Security Hub, supported standards (for example, CIS AWS Foundations) are automated and continuous checks that help determine your compliance status against security industry (including AWS) best practices.

BatchEnableStandards

StandardsSubscriptionRequests => ArrayRef[Paws::SecurityHub::StandardsSubscriptionRequest]

Each argument is described in detail in: Paws::SecurityHub::BatchEnableStandards

Returns: a Paws::SecurityHub::BatchEnableStandardsResponse instance

Enables the standards specified by the standards ARNs. In the context of Security Hub, supported standards (for example, CIS AWS Foundations) are automated and continuous checks that help determine your compliance status against security industry (including AWS) best practices.

BatchImportFindings

Findings => ArrayRef[Paws::SecurityHub::AwsSecurityFinding]

Each argument is described in detail in: Paws::SecurityHub::BatchImportFindings

Returns: a Paws::SecurityHub::BatchImportFindingsResponse instance

Imports security findings that are generated by the integrated third-party products into Security Hub.

CreateInsight

Filters => Paws::SecurityHub::AwsSecurityFindingFilters
GroupByAttribute => Str
Name => Str

Each argument is described in detail in: Paws::SecurityHub::CreateInsight

Returns: a Paws::SecurityHub::CreateInsightResponse instance

Creates an insight, which is a consolidation of findings that identifies a security area that requires attention or intervention.

CreateMembers

[AccountDetails => ArrayRef[Paws::SecurityHub::AccountDetails]]

Each argument is described in detail in: Paws::SecurityHub::CreateMembers

Returns: a Paws::SecurityHub::CreateMembersResponse instance

Creates member Security Hub accounts in the current AWS account (which becomes the master Security Hub account) that has Security Hub enabled.

DeclineInvitations

[AccountIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::DeclineInvitations

Returns: a Paws::SecurityHub::DeclineInvitationsResponse instance

Declines invitations that are sent to this AWS account (invitee) by the AWS accounts (inviters) that are specified by the account IDs.

DeleteInsight

InsightArn => Str

Each argument is described in detail in: Paws::SecurityHub::DeleteInsight

Returns: a Paws::SecurityHub::DeleteInsightResponse instance

Deletes an insight that is specified by the insight ARN.

DeleteInvitations

[AccountIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::DeleteInvitations

Returns: a Paws::SecurityHub::DeleteInvitationsResponse instance

Deletes invitations that are sent to this AWS account (invitee) by the AWS accounts (inviters) that are specified by their account IDs.

DeleteMembers

[AccountIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::DeleteMembers

Returns: a Paws::SecurityHub::DeleteMembersResponse instance

Deletes the Security Hub member accounts that are specified by the account IDs.

DisableImportFindingsForProduct

ProductSubscriptionArn => Str

Each argument is described in detail in: Paws::SecurityHub::DisableImportFindingsForProduct

Returns: a Paws::SecurityHub::DisableImportFindingsForProductResponse instance

Stops you from being able to import findings generated by integrated third-party providers into Security Hub.

DisableSecurityHub

Each argument is described in detail in: Paws::SecurityHub::DisableSecurityHub

Returns: a Paws::SecurityHub::DisableSecurityHubResponse instance

Disables the AWS Security Hub Service.

DisassociateFromMasterAccount

Each argument is described in detail in: Paws::SecurityHub::DisassociateFromMasterAccount

Returns: a Paws::SecurityHub::DisassociateFromMasterAccountResponse instance

Disassociates the current Security Hub member account from its master account.

DisassociateMembers

[AccountIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::DisassociateMembers

Returns: a Paws::SecurityHub::DisassociateMembersResponse instance

Disassociates the Security Hub member accounts that are specified by the account IDs from their master account.

EnableImportFindingsForProduct

ProductArn => Str

Each argument is described in detail in: Paws::SecurityHub::EnableImportFindingsForProduct

Returns: a Paws::SecurityHub::EnableImportFindingsForProductResponse instance

Enables you to import findings generated by integrated third-party providers into Security Hub.

EnableSecurityHub

Each argument is described in detail in: Paws::SecurityHub::EnableSecurityHub

Returns: a Paws::SecurityHub::EnableSecurityHubResponse instance

Enables the AWS Security Hub service.

GetEnabledStandards

[MaxResults => Int]
[NextToken => Str]
[StandardsSubscriptionArns => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::GetEnabledStandards

Returns: a Paws::SecurityHub::GetEnabledStandardsResponse instance

Lists and describes enabled standards.

GetFindings

[Filters => Paws::SecurityHub::AwsSecurityFindingFilters]
[MaxResults => Int]
[NextToken => Str]
[SortCriteria => ArrayRef[Paws::SecurityHub::SortCriterion]]

Each argument is described in detail in: Paws::SecurityHub::GetFindings

Returns: a Paws::SecurityHub::GetFindingsResponse instance

Lists and describes Security Hub-aggregated findings that are specified by filter attributes.

GetInsightResults

InsightArn => Str

Each argument is described in detail in: Paws::SecurityHub::GetInsightResults

Returns: a Paws::SecurityHub::GetInsightResultsResponse instance

Lists the results of the Security Hub insight specified by the insight ARN.

GetInsights

[InsightArns => ArrayRef[Str|Undef]]
[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::SecurityHub::GetInsights

Returns: a Paws::SecurityHub::GetInsightsResponse instance

Lists and describes insights that are specified by insight ARNs.

GetInvitationsCount

Each argument is described in detail in: Paws::SecurityHub::GetInvitationsCount

Returns: a Paws::SecurityHub::GetInvitationsCountResponse instance

Returns the count of all Security Hub membership invitations that were sent to the current member account, not including the currently accepted invitation.

GetMasterAccount

Each argument is described in detail in: Paws::SecurityHub::GetMasterAccount

Returns: a Paws::SecurityHub::GetMasterAccountResponse instance

Provides the details for the Security Hub master account to the current member account.

GetMembers

AccountIds => ArrayRef[Str|Undef]

Each argument is described in detail in: Paws::SecurityHub::GetMembers

Returns: a Paws::SecurityHub::GetMembersResponse instance

Returns the details on the Security Hub member accounts that are specified by the account IDs.

InviteMembers

[AccountIds => ArrayRef[Str|Undef]]

Each argument is described in detail in: Paws::SecurityHub::InviteMembers

Returns: a Paws::SecurityHub::InviteMembersResponse instance

Invites other AWS accounts to enable Security Hub and become Security Hub member accounts. When an account accepts the invitation and becomes a member account, the master account can view Security Hub findings of the member account.

ListEnabledProductsForImport

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::SecurityHub::ListEnabledProductsForImport

Returns: a Paws::SecurityHub::ListEnabledProductsForImportResponse instance

Lists all Security Hub-integrated third-party findings providers.

ListInvitations

[MaxResults => Int]
[NextToken => Str]

Each argument is described in detail in: Paws::SecurityHub::ListInvitations

Returns: a Paws::SecurityHub::ListInvitationsResponse instance

Lists all Security Hub membership invitations that were sent to the current AWS account.

ListMembers

[MaxResults => Int]
[NextToken => Str]
[OnlyAssociated => Bool]

Each argument is described in detail in: Paws::SecurityHub::ListMembers

Returns: a Paws::SecurityHub::ListMembersResponse instance

Lists details about all member accounts for the current Security Hub master account.

UpdateFindings

Filters => Paws::SecurityHub::AwsSecurityFindingFilters
[Note => Paws::SecurityHub::NoteUpdate]
[RecordState => Str]

Each argument is described in detail in: Paws::SecurityHub::UpdateFindings

Returns: a Paws::SecurityHub::UpdateFindingsResponse instance

Updates the AWS Security Hub-aggregated findings specified by the filter attributes.

UpdateInsight

InsightArn => Str
[Filters => Paws::SecurityHub::AwsSecurityFindingFilters]
[GroupByAttribute => Str]
[Name => Str]

Each argument is described in detail in: Paws::SecurityHub::UpdateInsight

Returns: a Paws::SecurityHub::UpdateInsightResponse instance

Updates the AWS Security Hub insight specified by the insight ARN.

PAGINATORS

Paginator methods are helpers that repetively call methods that return partial results

GetAllEnabledStandards(sub { },[MaxResults => Int, NextToken => Str, StandardsSubscriptionArns => ArrayRef[Str|Undef]])

GetAllEnabledStandards([MaxResults => Int, NextToken => Str, StandardsSubscriptionArns => ArrayRef[Str|Undef]])

If passed a sub as first parameter, it will call the sub for each element found in :

 - StandardsSubscriptions, passing the object as the first parameter, and the string 'StandardsSubscriptions' as the second parameter 

If not, it will return a a Paws::SecurityHub::GetEnabledStandardsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

GetAllFindings(sub { },[Filters => Paws::SecurityHub::AwsSecurityFindingFilters, MaxResults => Int, NextToken => Str, SortCriteria => ArrayRef[Paws::SecurityHub::SortCriterion]])

GetAllFindings([Filters => Paws::SecurityHub::AwsSecurityFindingFilters, MaxResults => Int, NextToken => Str, SortCriteria => ArrayRef[Paws::SecurityHub::SortCriterion]])

If passed a sub as first parameter, it will call the sub for each element found in :

 - Findings, passing the object as the first parameter, and the string 'Findings' as the second parameter 

If not, it will return a a Paws::SecurityHub::GetFindingsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

GetAllInsights(sub { },[InsightArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])

GetAllInsights([InsightArns => ArrayRef[Str|Undef], MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - Insights, passing the object as the first parameter, and the string 'Insights' as the second parameter 

If not, it will return a a Paws::SecurityHub::GetInsightsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllEnabledProductsForImport(sub { },[MaxResults => Int, NextToken => Str])

ListAllEnabledProductsForImport([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - ProductSubscriptions, passing the object as the first parameter, and the string 'ProductSubscriptions' as the second parameter 

If not, it will return a a Paws::SecurityHub::ListEnabledProductsForImportResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllInvitations(sub { },[MaxResults => Int, NextToken => Str])

ListAllInvitations([MaxResults => Int, NextToken => Str])

If passed a sub as first parameter, it will call the sub for each element found in :

 - Invitations, passing the object as the first parameter, and the string 'Invitations' as the second parameter 

If not, it will return a a Paws::SecurityHub::ListInvitationsResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

ListAllMembers(sub { },[MaxResults => Int, NextToken => Str, OnlyAssociated => Bool])

ListAllMembers([MaxResults => Int, NextToken => Str, OnlyAssociated => Bool])

If passed a sub as first parameter, it will call the sub for each element found in :

 - Members, passing the object as the first parameter, and the string 'Members' as the second parameter 

If not, it will return a a Paws::SecurityHub::ListMembersResponse instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.

SEE ALSO

This service class forms part of Paws

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues