View Source AWS.SecurityHub (aws-elixir v1.0.4)
Security Hub provides you with a comprehensive view of your security state in Amazon Web Services and helps you assess your Amazon Web Services environment against security industry standards and best practices.
Security Hub collects security data across Amazon Web Services accounts, Amazon Web Services services, and supported third-party products and helps you analyze your security trends and identify the highest priority security issues.
To help you manage the security state of your organization, Security Hub supports multiple security standards. These include the Amazon Web Services Foundational Security Best Practices (FSBP) standard developed by Amazon Web Services, and external compliance frameworks such as the Center for Internet Security (CIS), the Payment Card Industry Data Security Standard (PCI DSS), and the National Institute of Standards and Technology (NIST). Each standard includes several security controls, each of which represents a security best practice. Security Hub runs checks against security controls and generates control findings to help you assess your compliance against security best practices.
In addition to generating control findings, Security Hub also receives findings from other Amazon Web Services services, such as Amazon GuardDuty and Amazon Inspector, and supported third-party products. This gives you a single pane of glass into a variety of security-related issues. You can also send Security Hub findings to other Amazon Web Services services and supported third-party products.
Security Hub offers automation features that help you triage and remediate security issues. For example, you can use automation rules to automatically update critical findings when a security check fails. You can also leverage the integration with Amazon EventBridge to trigger automatic responses to specific findings.
This guide, the Security Hub API Reference, provides information about the Security Hub API. This includes supported resources, HTTP methods, parameters, and schemas. If you're new to Security Hub, you might find it helpful to also review the Security Hub User Guide . The user guide explains key concepts and provides procedures that demonstrate how to use Security Hub features. It also provides information about topics such as integrating Security Hub with other Amazon Web Services services.
In addition to interacting with Security Hub by making calls to the Security Hub API, you can use a current version of an Amazon Web Services command line tool or SDK. Amazon Web Services provides tools and SDKs that consist of libraries and sample code for various languages and platforms, such as PowerShell, Java, Go, Python, C++, and .NET. These tools and SDKs provide convenient, programmatic access to Security Hub and other Amazon Web Services services . They also handle tasks such as signing requests, managing errors, and retrying requests automatically. For information about installing and using the Amazon Web Services tools and SDKs, see Tools to Build on Amazon Web Services.
With the exception of operations that are related to central configuration, Security Hub API requests are executed only in the Amazon Web Services Region that is currently active or in the specific Amazon Web Services Region that you specify in your request. Any configuration or settings change that results from the operation is applied only to that Region. To make the same change in other Regions, call the same API operation in each Region in which you want to apply the change. When you use central configuration, API requests for enabling Security Hub, standards, and controls are executed in the home Region and all linked Regions. For a list of central configuration operations, see the Central configuration terms and concepts section of the Security Hub User Guide.
The following throttling limits apply to Security Hub API operations.
*
BatchEnableStandards
- RateLimit
of 1 request per
second. BurstLimit
of 1 request per second.
*
GetFindings
- RateLimit
of 3 requests per second.
BurstLimit
of 6 requests per second.
*
BatchImportFindings
- RateLimit
of 10 requests per second.
BurstLimit
of 30 requests per second.
*
BatchUpdateFindings
- RateLimit
of 10 requests per second.
BurstLimit
of 30 requests per second.
*
UpdateStandardsControl
- RateLimit
of 1 request per
second. BurstLimit
of 5 requests per second.
*
All other operations - RateLimit
of 10 requests per second.
BurstLimit
of 30 requests per second.
Link to this section Summary
Functions
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
This method is deprecated.
Deletes one or more automation rules.
Disables the standards specified by the provided
StandardsSubscriptionArns
.
Enables the standards specified by the provided StandardsArn
.
Retrieves a list of details for automation rules based on rule Amazon Resource Names (ARNs).
Returns associations between an Security Hub configuration and a batch of target accounts, organizational units, or the root.
Provides details about a batch of security controls for the current Amazon Web Services account and Amazon Web Services Region.
For a batch of security controls and standards, identifies whether each control is currently enabled or disabled in a standard.
Imports security findings generated by a finding provider into Security Hub.
Updates one or more automation rules based on rule Amazon Resource Names (ARNs) and input parameters.
Used by Security Hub customers to update information about their investigation into a finding.
For a batch of security controls and standards, this operation updates the enablement status of a control in a standard.
Creates a custom action target in Security Hub.
Creates an automation rule based on input parameters.
Creates a configuration policy with the defined configuration.
The aggregation Region is now called the home Region.
Creates a custom insight in Security Hub.
Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the administrator account.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
Deletes a custom action target from Security Hub.
Deletes a configuration policy.
The aggregation Region is now called the home Region.
Deletes the insight specified by the InsightArn
.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
Deletes the specified member accounts from Security Hub.
Returns a list of the custom action targets in Security Hub in your account.
Returns details about the Hub resource in your account, including the
HubArn
and the time when you enabled Security Hub.
Returns information about the way your organization is configured in Security Hub.
Returns information about product integrations in Security Hub.
Returns a list of the available standards in Security Hub.
Returns a list of security standards controls.
Disables the integration of the specified product with Security Hub.
Disables a Security Hub administrator account.
Disables Security Hub in your account only in the current Amazon Web Services Region.
Disassociates the current Security Hub member account from the associated administrator account.
This method is deprecated.
Disassociates the specified member accounts from the associated administrator account.
Enables the integration of a partner product with Security Hub.
Designates the Security Hub administrator account for an organization.
Enables Security Hub for your account in the current Region or the Region you specify in the request.
Provides the details for the Security Hub administrator account for the current member account.
Provides information about a configuration policy.
Returns the association between a configuration and a target account, organizational unit, or the root.
Returns a list of the standards that are currently enabled.
The aggregation Region is now called the home Region.
Returns history for a Security Hub finding in the last 90 days.
Returns a list of findings that match the specified criteria.
Lists the results of the Security Hub insight specified by the insight ARN.
Lists and describes insights for the specified insight ARNs.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
This method is deprecated.
Returns the details for the Security Hub member accounts for the specified account IDs.
Retrieves the definition of a security control.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
A list of automation rules and their metadata for the calling account.
Lists the configuration policies that the Security Hub delegated administrator has created for your organization.
Provides information about the associations for your configuration policies and self-managed behavior.
Lists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.
If cross-Region aggregation is enabled, then ListFindingAggregators
returns
the Amazon Resource Name (ARN)
of the finding aggregator.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
Lists details about all member accounts for the current Security Hub administrator account.
Lists the Security Hub administrator accounts.
Lists all of the security controls that apply to a specified standard.
Specifies whether a control is currently enabled or disabled in each enabled standard in the calling account.
Returns a list of tags associated with a resource.
Associates a target account, organizational unit, or the root with a specified configuration.
Disassociates a target account, organizational unit, or the root from a specified configuration.
Adds one or more tags to a resource.
Removes one or more tags from a resource.
Updates the name and description of a custom action target in Security Hub.
Updates a configuration policy.
The aggregation Region is now called the home Region.
UpdateFindings
is a deprecated operation.
Updates the Security Hub insight identified by the specified insight ARN.
Updates the configuration of your organization in Security Hub.
Updates the properties of a security control.
Updates configuration options for Security Hub.
Used to control whether an individual security standard control is enabled or disabled.
Link to this section Functions
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Accepts the invitation to be a member account and be monitored by the Security Hub administrator account that the invitation was sent from.
This operation is only used by member accounts that are not added through Organizations.
When the member account accepts the invitation, permission is granted to the administrator account to view findings generated in the member account.
This method is deprecated.
Instead, use AcceptAdministratorInvitation
.
The Security Hub console continues to use AcceptInvitation
. It will eventually
change to use AcceptAdministratorInvitation
. Any IAM policies that
specifically control access to this function must continue to use
AcceptInvitation
. You should also add AcceptAdministratorInvitation
to your
policies to ensure that the correct permissions are in place after the console
begins to use AcceptAdministratorInvitation
.
Accepts the invitation to be a member account and be monitored by the Security Hub administrator account that the invitation was sent from.
This operation is only used by member accounts that are not added through Organizations.
When the member account accepts the invitation, permission is granted to the administrator account to view findings generated in the member account.
Deletes one or more automation rules.
Disables the standards specified by the provided
StandardsSubscriptionArns
.
For more information, see Security Standards section of the Security Hub User Guide.
Enables the standards specified by the provided StandardsArn
.
To obtain the
ARN for a standard, use the DescribeStandards
operation.
For more information, see the Security Standards section of the Security Hub User Guide.
Retrieves a list of details for automation rules based on rule Amazon Resource Names (ARNs).
batch_get_configuration_policy_associations(client, input, options \\ [])
View SourceReturns associations between an Security Hub configuration and a batch of target accounts, organizational units, or the root.
Only the Security Hub delegated administrator can invoke this operation from the home Region. A configuration can refer to a configuration policy or to a self-managed configuration.
Provides details about a batch of security controls for the current Amazon Web Services account and Amazon Web Services Region.
batch_get_standards_control_associations(client, input, options \\ [])
View SourceFor a batch of security controls and standards, identifies whether each control is currently enabled or disabled in a standard.
Imports security findings generated by a finding provider into Security Hub.
This action is requested by the finding provider to import its findings into Security Hub.
BatchImportFindings
must be called by one of the following:
*
The Amazon Web Services account that is associated with a finding if you are
using
the default product ARN
or are a partner sending findings from within a customer's Amazon Web Services
account.
In these cases, the identifier of the account that you are calling
BatchImportFindings
from needs to be the same as the AwsAccountId
attribute for the finding.
*
An Amazon Web Services account that Security Hub has allow-listed for an
official partner
integration. In this case, you can call BatchImportFindings
from the
allow-listed
account and send findings from different customer accounts in the same batch.
The maximum allowed size for a finding is 240 Kb. An error is returned for any finding larger than 240 Kb.
After a finding is created, BatchImportFindings
cannot be used to update
the following finding fields and objects, which Security Hub customers use to
manage their
investigation workflow.
*
Note
*
UserDefinedFields
*
VerificationState
*
Workflow
Finding providers also should not use BatchImportFindings
to update the
following attributes.
*
Confidence
*
Criticality
*
RelatedFindings
*
Severity
*
Types
Instead, finding providers use FindingProviderFields
to provide values for
these attributes.
Updates one or more automation rules based on rule Amazon Resource Names (ARNs) and input parameters.
Used by Security Hub customers to update information about their investigation into a finding.
Requested by administrator accounts or member accounts. Administrator accounts can update findings for their account and their member accounts. Member accounts can update findings for their account.
Updates from BatchUpdateFindings
don't affect the value of
UpdatedAt
for a finding.
Administrator and member accounts can use BatchUpdateFindings
to update the
following finding fields and objects.
*
Confidence
*
Criticality
*
Note
*
RelatedFindings
*
Severity
*
Types
*
UserDefinedFields
*
VerificationState
*
Workflow
You can configure IAM policies to restrict access to fields and field values. For example, you might not want member accounts to be able to suppress findings or change the finding severity. See Configuring access to BatchUpdateFindings in the Security Hub User Guide.
batch_update_standards_control_associations(client, input, options \\ [])
View SourceFor a batch of security controls and standards, this operation updates the enablement status of a control in a standard.
Creates a custom action target in Security Hub.
You can use custom actions on findings and insights in Security Hub to trigger target actions in Amazon CloudWatch Events.
Creates an automation rule based on input parameters.
Creates a configuration policy with the defined configuration.
Only the Security Hub delegated administrator can invoke this operation from the home Region.
The aggregation Region is now called the home Region.
Used to enable cross-Region aggregation. This operation can be invoked from the home Region only.
For information about how cross-Region aggregation works, see Understanding cross-Region aggregation in Security Hub in the Security Hub User Guide.
Creates a custom insight in Security Hub.
An insight is a consolidation of findings that relate to a security issue that requires attention or remediation.
To group the related findings in the insight, use the
GroupByAttribute
.
Creates a member association in Security Hub between the specified accounts and the account used to make the request, which is the administrator account.
If you are integrated with Organizations, then the administrator account is designated by the organization management account.
CreateMembers
is always used to add accounts that are not organization
members.
For accounts that are managed using Organizations, CreateMembers
is only used
in the following cases:
* Security Hub is not configured to automatically add new organization accounts.
* The account was disassociated or deleted in Security Hub.
This action can only be used by an account that has Security Hub enabled. To
enable Security Hub, you
can use the EnableSecurityHub
operation.
For accounts that are not organization members, you create the account
association and
then send an invitation to the member account. To send the invitation, you use
the
InviteMembers
operation. If the account owner accepts
the invitation, the account becomes a member account in Security Hub.
Accounts that are managed using Organizations don't receive an invitation. They automatically become a member account in Security Hub.
* If the organization account does not have Security Hub enabled, then Security Hub and the default standards are automatically enabled. Note that Security Hub cannot be enabled automatically for the organization management account. The organization management account must enable Security Hub before the administrator account enables it as a member account.
* For organization accounts that already have Security Hub enabled, Security Hub does not make any other changes to those accounts. It does not change their enabled standards or controls.
A permissions policy is added that permits the administrator account to view the findings generated in the member account.
To remove the association between the administrator and member accounts, use the
DisassociateFromMasterAccount
or DisassociateMembers
operation.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Declines invitations to become a Security Hub member account.
A prospective member account uses this operation to decline an invitation to become a member.
Only member accounts that aren't part of an Amazon Web Services organization should use this operation. Organization accounts don't receive invitations.
delete_action_target(client, action_target_arn, input, options \\ [])
View SourceDeletes a custom action target from Security Hub.
Deleting a custom action target does not affect any findings or insights that were already sent to Amazon CloudWatch Events using the custom action.
delete_configuration_policy(client, identifier, input, options \\ [])
View SourceDeletes a configuration policy.
Only the Security Hub delegated administrator can invoke this operation
from the home Region. For the deletion to succeed, you must first disassociate a
configuration policy from target accounts,
organizational units, or the root by invoking the
StartConfigurationPolicyDisassociation
operation.
delete_finding_aggregator(client, finding_aggregator_arn, input, options \\ [])
View SourceThe aggregation Region is now called the home Region.
Deletes a finding aggregator. When you delete the finding aggregator, you stop cross-Region aggregation. Finding replication stops occurring from the linked Regions to the home Region.
When you stop cross-Region aggregation, findings that were already replicated and sent to the home Region are still visible from the home Region. However, new findings and finding updates are no longer replicated and sent to the home Region.
Deletes the insight specified by the InsightArn
.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Deletes invitations to become a Security Hub member account.
A Security Hub administrator account can use this operation to delete invitations sent to one or more prospective member accounts.
This operation is only used to delete invitations that are sent to prospective member accounts that aren't part of an Amazon Web Services organization. Organization accounts don't receive invitations.
Deletes the specified member accounts from Security Hub.
You can invoke this API only to delete accounts that became members through invitation. You can't invoke this API to delete accounts that belong to an Organizations organization.
Returns a list of the custom action targets in Security Hub in your account.
Returns details about the Hub resource in your account, including the
HubArn
and the time when you enabled Security Hub.
Returns information about the way your organization is configured in Security Hub.
Only the Security Hub administrator account can invoke this operation.
describe_products(client, max_results \\ nil, next_token \\ nil, product_arn \\ nil, options \\ [])
View SourceReturns information about product integrations in Security Hub.
You can optionally provide an integration ARN. If you provide an integration ARN, then the results only include that integration.
If you don't provide an integration ARN, then the results include all of the available product integrations.
describe_standards(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceReturns a list of the available standards in Security Hub.
For each standard, the results include the standard ARN, the name, and a description.
describe_standards_controls(client, standards_subscription_arn, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceReturns a list of security standards controls.
For each control, the results include information about whether it is currently enabled, the severity, and a link to remediation information.
disable_import_findings_for_product(client, product_subscription_arn, input, options \\ [])
View SourceDisables the integration of the specified product with Security Hub.
After the integration is disabled, findings from that product are no longer sent to Security Hub.
Disables a Security Hub administrator account.
Can only be called by the organization management account.
Disables Security Hub in your account only in the current Amazon Web Services Region.
To disable Security Hub in all Regions, you must submit one request per Region where you have enabled Security Hub.
You can't disable Security Hub in an account that is currently the Security Hub administrator.
When you disable Security Hub, your existing findings and insights and any Security Hub configuration settings are deleted after 90 days and cannot be recovered. Any standards that were enabled are disabled, and your administrator and member account associations are removed.
If you want to save your existing findings, you must export them before you disable Security Hub.
disassociate_from_administrator_account(client, input, options \\ [])
View SourceDisassociates the current Security Hub member account from the associated administrator account.
This operation is only used by accounts that are not part of an organization. For organization accounts, only the administrator account can disassociate a member account.
This method is deprecated.
Instead, use DisassociateFromAdministratorAccount
.
The Security Hub console continues to use DisassociateFromMasterAccount
. It
will eventually change to use DisassociateFromAdministratorAccount
. Any IAM
policies that specifically control access to this function must continue to use
DisassociateFromMasterAccount
. You should also add
DisassociateFromAdministratorAccount
to your policies to ensure that the
correct permissions are in place after the console begins to use
DisassociateFromAdministratorAccount
.
Disassociates the current Security Hub member account from the associated administrator account.
This operation is only used by accounts that are not part of an organization. For organization accounts, only the administrator account can disassociate a member account.
Disassociates the specified member accounts from the associated administrator account.
Can be used to disassociate both accounts that are managed using Organizations and accounts that were invited manually.
Enables the integration of a partner product with Security Hub.
Integrated products send findings to Security Hub.
When you enable a product integration, a permissions policy that grants permission for the product to send findings to Security Hub is applied.
Designates the Security Hub administrator account for an organization.
Can only be called by the organization management account.
Enables Security Hub for your account in the current Region or the Region you specify in the request.
When you enable Security Hub, you grant to Security Hub the permissions necessary to gather findings from other services that are integrated with Security Hub.
When you use the EnableSecurityHub
operation to enable Security Hub, you also
automatically enable the following standards:
* Center for Internet Security (CIS) Amazon Web Services Foundations Benchmark v1.2.0
* Amazon Web Services Foundational Security Best Practices
Other standards are not automatically enabled.
To opt out of automatically enabled standards, set
EnableDefaultStandards
to false
.
After you enable Security Hub, to enable a standard, use the
BatchEnableStandards
operation. To disable a standard, use the
BatchDisableStandards
operation.
To learn more, see the setup information in the Security Hub User Guide.
Provides the details for the Security Hub administrator account for the current member account.
Can be used by both member accounts that are managed using Organizations and accounts that were invited manually.
Provides information about a configuration policy.
Only the Security Hub delegated administrator can invoke this operation from the home Region.
get_configuration_policy_association(client, input, options \\ [])
View SourceReturns the association between a configuration and a target account, organizational unit, or the root.
The configuration can be a configuration policy or self-managed behavior. Only the Security Hub delegated administrator can invoke this operation from the home Region.
Returns a list of the standards that are currently enabled.
get_finding_aggregator(client, finding_aggregator_arn, options \\ [])
View SourceThe aggregation Region is now called the home Region.
Returns the current configuration in the calling account for cross-Region aggregation. A finding aggregator is a resource that establishes the home Region and any linked Regions.
Returns history for a Security Hub finding in the last 90 days.
The history includes changes made to any fields in the Amazon Web Services Security Finding Format (ASFF).
Returns a list of findings that match the specified criteria.
If cross-Region aggregation is enabled, then when you call GetFindings
from
the home Region, the results include all of the matching findings from both the
home Region and linked Regions.
Lists the results of the Security Hub insight specified by the insight ARN.
Lists and describes insights for the specified insight ARNs.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Returns the count of all Security Hub membership invitations that were sent to the calling member account, not including the currently accepted invitation.
This method is deprecated.
Instead, use GetAdministratorAccount
.
The Security Hub console continues to use GetMasterAccount
. It will eventually
change to use GetAdministratorAccount
. Any IAM policies that specifically
control access to this function must continue to use GetMasterAccount
. You
should also add GetAdministratorAccount
to your policies to ensure that the
correct permissions are in place after the console begins to use
GetAdministratorAccount
.
Provides the details for the Security Hub administrator account for the current member account.
Can be used by both member accounts that are managed using Organizations and accounts that were invited manually.
Returns the details for the Security Hub member accounts for the specified account IDs.
An administrator account can be either the delegated Security Hub administrator account for an organization or an administrator account that enabled Security Hub manually.
The results include both member accounts that are managed using Organizations and accounts that were invited manually.
get_security_control_definition(client, security_control_id, options \\ [])
View SourceRetrieves the definition of a security control.
The definition includes the control title, description, Region availability, parameter definitions, and other details.
We recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Invites other Amazon Web Services accounts to become member accounts for the Security Hub administrator account that the invitation is sent from.
This operation is only used to invite accounts that don't belong to an Amazon Web Services organization. Organization accounts don't receive invitations.
Before you can use this action to invite a member, you must first use the
CreateMembers
action to create the member account in Security Hub.
When the account owner enables Security Hub and accepts the invitation to become a member account, the administrator account can view the findings generated in the member account.
list_automation_rules(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceA list of automation rules and their metadata for the calling account.
list_configuration_policies(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the configuration policies that the Security Hub delegated administrator has created for your organization.
Only the delegated administrator can invoke this operation from the home Region.
list_configuration_policy_associations(client, input, options \\ [])
View SourceProvides information about the associations for your configuration policies and self-managed behavior.
Only the Security Hub delegated administrator can invoke this operation from the home Region.
list_enabled_products_for_import(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists all findings-generating solutions (products) that you are subscribed to receive findings from in Security Hub.
list_finding_aggregators(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceIf cross-Region aggregation is enabled, then ListFindingAggregators
returns
the Amazon Resource Name (ARN)
of the finding aggregator.
You can run this operation from any Amazon Web Services Region.
list_invitations(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceWe recommend using Organizations instead of Security Hub invitations to manage your member accounts.
For information, see Managing Security Hub administrator and member accounts with Organizations in the Security Hub User Guide.
Lists all Security Hub membership invitations that were sent to the calling account.
Only accounts that are managed by invitation can use this operation. Accounts that are managed using the integration with Organizations don't receive invitations.
list_members(client, max_results \\ nil, next_token \\ nil, only_associated \\ nil, options \\ [])
View SourceLists details about all member accounts for the current Security Hub administrator account.
The results include both member accounts that belong to an organization and member accounts that were invited manually.
list_organization_admin_accounts(client, max_results \\ nil, next_token \\ nil, options \\ [])
View SourceLists the Security Hub administrator accounts.
Can only be called by the organization management account.
list_security_control_definitions(client, max_results \\ nil, next_token \\ nil, standards_arn \\ nil, options \\ [])
View SourceLists all of the security controls that apply to a specified standard.
list_standards_control_associations(client, max_results \\ nil, next_token \\ nil, security_control_id, options \\ [])
View SourceSpecifies whether a control is currently enabled or disabled in each enabled standard in the calling account.
Returns a list of tags associated with a resource.
start_configuration_policy_association(client, input, options \\ [])
View SourceAssociates a target account, organizational unit, or the root with a specified configuration.
The target can be associated with a configuration policy or self-managed behavior. Only the Security Hub delegated administrator can invoke this operation from the home Region.
start_configuration_policy_disassociation(client, input, options \\ [])
View SourceDisassociates a target account, organizational unit, or the root from a specified configuration.
When you disassociate a configuration from its target, the target inherits the configuration of the closest parent. If there’s no configuration to inherit, the target retains its settings but becomes a self-managed account. A target can be disassociated from a configuration policy or self-managed behavior. Only the Security Hub delegated administrator can invoke this operation from the home Region.
Adds one or more tags to a resource.
Removes one or more tags from a resource.
update_action_target(client, action_target_arn, input, options \\ [])
View SourceUpdates the name and description of a custom action target in Security Hub.
update_configuration_policy(client, identifier, input, options \\ [])
View SourceUpdates a configuration policy.
Only the Security Hub delegated administrator can invoke this operation from the home Region.
The aggregation Region is now called the home Region.
Updates cross-Region aggregation settings. You can use this operation to update the Region linking mode and the list of included or excluded Amazon Web Services Regions. However, you can't use this operation to change the home Region.
You can invoke this operation from the current home Region only.
UpdateFindings
is a deprecated operation.
Instead of UpdateFindings
, use
the BatchUpdateFindings
operation.
The UpdateFindings
operation updates the Note
and RecordState
of the
Security Hub aggregated
findings that the filter attributes specify. Any member account that can view
the finding
can also see the update to the finding.
Finding updates made with UpdateFindings
aren't persisted if the same finding
is later updated by the
finding provider through the BatchImportFindings
operation. In addition,
Security Hub doesn't
record updates made with UpdateFindings
in the finding history.
Updates the Security Hub insight identified by the specified insight ARN.
Updates the configuration of your organization in Security Hub.
Only the Security Hub administrator account can invoke this operation.
Updates the properties of a security control.
Updates configuration options for Security Hub.
update_standards_control(client, standards_control_arn, input, options \\ [])
View SourceUsed to control whether an individual security standard control is enabled or disabled.