Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. configuration
  6. RemediationConfiguration

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.68.0
published on Monday, Jun 1, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

aws-native.configuration.RemediationConfiguration

aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.68.0
published on Monday, Jun 1, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-aws-native

    Resource Type definition for AWS::Config::RemediationConfiguration

    Create RemediationConfiguration Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new RemediationConfiguration(name: string, args: RemediationConfigurationArgs, opts?: CustomResourceOptions);
    @overload
def RemediationConfiguration(resource_name: str,
                             args: RemediationConfigurationArgs,
                             opts: Optional[ResourceOptions] = None)

@overload
def RemediationConfiguration(resource_name: str,
                             opts: Optional[ResourceOptions] = None,
                             config_rule_name: Optional[str] = None,
                             target_id: Optional[str] = None,
                             target_type: Optional[str] = None,
                             automatic: Optional[bool] = None,
                             execution_controls: Optional[RemediationConfigurationExecutionControlsArgs] = None,
                             maximum_automatic_attempts: Optional[int] = None,
                             parameters: Optional[Any] = None,
                             resource_type: Optional[str] = None,
                             retry_attempt_seconds: Optional[int] = None,
                             target_version: Optional[str] = None)
    func NewRemediationConfiguration(ctx *Context, name string, args RemediationConfigurationArgs, opts ...ResourceOption) (*RemediationConfiguration, error)
    public RemediationConfiguration(string name, RemediationConfigurationArgs args, CustomResourceOptions? opts = null)
    public RemediationConfiguration(String name, RemediationConfigurationArgs args)
public RemediationConfiguration(String name, RemediationConfigurationArgs args, CustomResourceOptions options)

    type: aws-native:configuration:RemediationConfiguration
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "aws-native_configuration_remediationconfiguration" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args RemediationConfigurationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args RemediationConfigurationArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args RemediationConfigurationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RemediationConfigurationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RemediationConfigurationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    RemediationConfiguration Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The RemediationConfiguration resource accepts the following input properties:

    ConfigRuleName string
    The name of the AWS Config rule.
    TargetId string
    Target ID is the name of the SSM document.
    TargetType string
    The type of the target. Target executes remediation. For example, SSM document.
    Automatic bool
    The remediation is triggered automatically.
    ExecutionControls Pulumi.AwsNative.Configuration.Inputs.RemediationConfigurationExecutionControls
    An ExecutionControls object.
    MaximumAutomaticAttempts int

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    Parameters object

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    ResourceType string
    The type of a resource.
    RetryAttemptSeconds int

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    TargetVersion string

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    ConfigRuleName string
    The name of the AWS Config rule.
    TargetId string
    Target ID is the name of the SSM document.
    TargetType string
    The type of the target. Target executes remediation. For example, SSM document.
    Automatic bool
    The remediation is triggered automatically.
    ExecutionControls RemediationConfigurationExecutionControlsArgs
    An ExecutionControls object.
    MaximumAutomaticAttempts int

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    Parameters interface{}

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    ResourceType string
    The type of a resource.
    RetryAttemptSeconds int

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    TargetVersion string

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    config_rule_name string
    The name of the AWS Config rule.
    target_id string
    Target ID is the name of the SSM document.
    target_type string
    The type of the target. Target executes remediation. For example, SSM document.
    automatic bool
    The remediation is triggered automatically.
    execution_controls object
    An ExecutionControls object.
    maximum_automatic_attempts number

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    parameters any

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    resource_type string
    The type of a resource.
    retry_attempt_seconds number

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    target_version string

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    configRuleName String
    The name of the AWS Config rule.
    targetId String
    Target ID is the name of the SSM document.
    targetType String
    The type of the target. Target executes remediation. For example, SSM document.
    automatic Boolean
    The remediation is triggered automatically.
    executionControls RemediationConfigurationExecutionControls
    An ExecutionControls object.
    maximumAutomaticAttempts Integer

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    parameters Object

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    resourceType String
    The type of a resource.
    retryAttemptSeconds Integer

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    targetVersion String

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    configRuleName string
    The name of the AWS Config rule.
    targetId string
    Target ID is the name of the SSM document.
    targetType string
    The type of the target. Target executes remediation. For example, SSM document.
    automatic boolean
    The remediation is triggered automatically.
    executionControls RemediationConfigurationExecutionControls
    An ExecutionControls object.
    maximumAutomaticAttempts number

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    parameters any

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    resourceType string
    The type of a resource.
    retryAttemptSeconds number

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    targetVersion string

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    config_rule_name str
    The name of the AWS Config rule.
    target_id str
    Target ID is the name of the SSM document.
    target_type str
    The type of the target. Target executes remediation. For example, SSM document.
    automatic bool
    The remediation is triggered automatically.
    execution_controls RemediationConfigurationExecutionControlsArgs
    An ExecutionControls object.
    maximum_automatic_attempts int

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    parameters Any

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    resource_type str
    The type of a resource.
    retry_attempt_seconds int

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    target_version str

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    configRuleName String
    The name of the AWS Config rule.
    targetId String
    Target ID is the name of the SSM document.
    targetType String
    The type of the target. Target executes remediation. For example, SSM document.
    automatic Boolean
    The remediation is triggered automatically.
    executionControls Property Map
    An ExecutionControls object.
    maximumAutomaticAttempts Number

    The maximum number of failed attempts for auto-remediation. If you do not select a number, the default is 5.

    For example, if you specify MaximumAutomaticAttempts as 5 with RetryAttemptSeconds as 50 seconds, AWS Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

    parameters Any

    An object of the RemediationParameterValue. For more information, see RemediationParameterValue .

    The type is a map of strings to RemediationParameterValue.

    Search the CloudFormation User Guide for AWS::Config::RemediationConfiguration for more information about the expected schema for this property.

    resourceType String
    The type of a resource.
    retryAttemptSeconds Number

    Time window to determine whether or not to add a remediation exception to prevent infinite remediation attempts. If MaximumAutomaticAttempts remediation attempts have been made under RetryAttemptSeconds , a remediation exception will be added to the resource. If you do not select a number, the default is 60 seconds.

    For example, if you specify RetryAttemptSeconds as 50 seconds and MaximumAutomaticAttempts as 5, AWS Config will run auto-remediations 5 times within 50 seconds before adding a remediation exception to the resource.

    targetVersion String

    Version of the target. For example, version of the SSM document.

    If you make backward incompatible changes to the SSM document, you must call PutRemediationConfiguration API again to ensure the remediations can run.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the RemediationConfiguration resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    RemediationConfigurationExecutionControls, RemediationConfigurationExecutionControlsArgs

    ssm_controls object
    A SsmControls object.
    ssmControls Property Map
    A SsmControls object.

    RemediationConfigurationSsmControls, RemediationConfigurationSsmControlsArgs

    ConcurrentExecutionRatePercentage int
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    ErrorPercentage int
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    ConcurrentExecutionRatePercentage int
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    ErrorPercentage int
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    concurrent_execution_rate_percentage number
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    error_percentage number
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    concurrentExecutionRatePercentage Integer
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    errorPercentage Integer
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    concurrentExecutionRatePercentage number
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    errorPercentage number
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    concurrent_execution_rate_percentage int
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    error_percentage int
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.
    concurrentExecutionRatePercentage Number
    The maximum percentage of remediation actions allowed to run in parallel on the non-compliant resources for that specific rule. You can specify a percentage, such as 10%. The default value is 10.
    errorPercentage Number
    The percentage of errors that are allowed before SSM stops running automations on non-compliant resources for that specific rule. You can specify a percentage of errors, for example 10%. If you do not specifiy a percentage, the default is 50%. For example, if you set the ErrorPercentage to 40% for 10 non-compliant resources, then SSM stops running the automations when the fifth error is received.

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.68.0
    published on Monday, Jun 1, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-aws-native

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial