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

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.getRemediationConfiguration

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

    Using getRemediationConfiguration

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getRemediationConfiguration(args: GetRemediationConfigurationArgs, opts?: InvokeOptions): Promise<GetRemediationConfigurationResult>
function getRemediationConfigurationOutput(args: GetRemediationConfigurationOutputArgs, opts?: InvokeOptions): Output<GetRemediationConfigurationResult>
    def get_remediation_configuration(config_rule_name: Optional[str] = None,
                                  opts: Optional[InvokeOptions] = None) -> GetRemediationConfigurationResult
def get_remediation_configuration_output(config_rule_name: pulumi.Input[Optional[str]] = None,
                                  opts: Optional[InvokeOptions] = None) -> Output[GetRemediationConfigurationResult]
    func LookupRemediationConfiguration(ctx *Context, args *LookupRemediationConfigurationArgs, opts ...InvokeOption) (*LookupRemediationConfigurationResult, error)
func LookupRemediationConfigurationOutput(ctx *Context, args *LookupRemediationConfigurationOutputArgs, opts ...InvokeOption) LookupRemediationConfigurationResultOutput

    > Note: This function is named LookupRemediationConfiguration in the Go SDK.

    public static class GetRemediationConfiguration 
{
    public static Task<GetRemediationConfigurationResult> InvokeAsync(GetRemediationConfigurationArgs args, InvokeOptions? opts = null)
    public static Output<GetRemediationConfigurationResult> Invoke(GetRemediationConfigurationInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRemediationConfigurationResult> getRemediationConfiguration(GetRemediationConfigurationArgs args, InvokeOptions options)
public static Output<GetRemediationConfigurationResult> getRemediationConfiguration(GetRemediationConfigurationArgs args, InvokeOptions options)

    fn::invoke:
  function: aws-native:configuration:getRemediationConfiguration
  arguments:
    # arguments dictionary
    data "aws-native_configuration_getremediationconfiguration" "name" {
    # arguments
}

    The following arguments are supported:

    ConfigRuleName string
    The name of the AWS Config rule.
    ConfigRuleName string
    The name of the AWS Config rule.
    config_rule_name string
    The name of the AWS Config rule.
    configRuleName String
    The name of the AWS Config rule.
    configRuleName string
    The name of the AWS Config rule.
    config_rule_name str
    The name of the AWS Config rule.
    configRuleName String
    The name of the AWS Config rule.

    getRemediationConfiguration Result

    The following output properties are available:

    Automatic bool
    The remediation is triggered automatically.
    ExecutionControls Pulumi.AwsNative.Configuration.Outputs.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.

    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.
    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.

    Automatic bool
    The remediation is triggered automatically.
    ExecutionControls 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 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.

    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.
    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.

    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_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.
    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.

    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.

    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.
    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.

    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.

    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.
    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.

    automatic bool
    The remediation is triggered automatically.
    execution_controls RemediationConfigurationExecutionControls
    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_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.
    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.

    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.

    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.
    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.

    Supporting Types

    RemediationConfigurationExecutionControls

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

    RemediationConfigurationSsmControls

    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