AutomationRulesConfig
Defines the configuration of an automation rule.
Contents
- Actions
-
One or more actions to update finding fields if a finding matches the defined criteria of the rule.
Type: Array of AutomationRulesAction objects
Array Members: Fixed number of 1 item.
Required: No
- CreatedAt
-
A timestamp that indicates when the rule was created.
For more information about the validation and formatting of timestamp fields in Amazon Security Hub, see Timestamps.
Type: Timestamp
Required: No
- CreatedBy
-
The principal that created a rule.
Type: String
Pattern:
.*\S.*Required: No
- Criteria
-
A set of Amazon Security Finding Format finding field attributes and corresponding expected values that Security Hub uses to filter findings. If a rule is enabled and a finding matches the conditions specified in this parameter, Security Hub applies the rule action to the finding.
Type: AutomationRulesFindingFilters object
Required: No
- Description
-
A description of the rule.
Type: String
Pattern:
.*\S.*Required: No
- IsTerminal
-
Specifies whether a rule is the last to be applied with respect to a finding that matches the rule criteria. This is useful when a finding matches the criteria for multiple rules, and each rule has different actions. If a rule is terminal, Security Hub applies the rule action to a finding that matches the rule criteria and doesn't evaluate other rules for the finding. By default, a rule isn't terminal.
Type: Boolean
Required: No
- RuleArn
-
The Amazon Resource Name (ARN) of a rule.
Type: String
Pattern:
.*\S.*Required: No
- RuleName
-
The name of the rule.
Type: String
Pattern:
.*\S.*Required: No
- RuleOrder
-
An integer ranging from 1 to 1000 that represents the order in which the rule action is applied to findings. Security Hub applies rules with lower values for this parameter first.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 1000.
Required: No
- RuleStatus
-
Whether the rule is active after it is created. If this parameter is equal to
ENABLED, Security Hub starts applying the rule to findings and finding updates after the rule is created.Type: String
Valid Values:
ENABLED | DISABLEDRequired: No
- UpdatedAt
-
A timestamp that indicates when the rule was most recently updated.
For more information about the validation and formatting of timestamp fields in Amazon Security Hub, see Timestamps.
Type: Timestamp
Required: No
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: