/

POST

Returns the details of one or more remediation configurations.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ConfigRuleNames": []
}'

Response Example

{
    "RemediationConfigurations": []
}

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

ConfigRuleNames

array[string]

required

A list of Config rule names of remediation configurations for which you want details.

>= 0 items<= 25 items

Examples

Responses

🟢200Success

application/json

Body

RemediationConfigurations

array[object (RemediationConfiguration) {12}]

optional

Returns a remediation configuration object.

>= 0 items<= 25 items

ConfigRuleName

string

required

The name of the Config rule.

>= 1 characters<= 128 characters

Match pattern:

.*\S.*

TargetType

enum<string>

required

The type of the target. Target executes remediation. For example, SSM document.

Allowed value:

SSM_DOCUMENT

TargetId

string

required

Target ID is the name of the SSM document.

>= 1 characters<= 256 characters

TargetVersion

string

optional

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

Parameters

object

optional

An object of the RemediationParameterValue.

ResourceType

string

optional

The type of a resource.

Automatic

boolean

optional

The remediation is triggered automatically.

ExecutionControls

object

optional

An ExecutionControls object.

MaximumAutomaticAttempts

integer

optional

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, Config will put a RemediationException on your behalf for the failing resource after the 5th failed attempt within 50 seconds.

>= 1<= 25

RetryAttemptSeconds

integer

optional

Maximum time in seconds that Config runs auto-remediation. 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, Config will run auto-remediations 5 times within 50 seconds before throwing an exception.

>= 1<= 2678000

Arn

string

optional

Amazon Resource Name (ARN) of remediation configuration.

>= 1 characters<= 1024 characters

CreatedByService

string

optional

Name of the service that owns the service-linked rule, if applicable.

>= 1 characters<= 1024 characters