Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . configservice ]

put-remediation-configurations

Description

Adds or updates the remediation configuration with a specific AWS Config rule with the selected target or action. The API creates the RemediationConfiguration object for the AWS Config rule. The AWS Config rule must already exist for you to add a remediation configuration. The target (SSM document) must exist and have permissions to use the target.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  put-remediation-configurations
--remediation-configurations <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--remediation-configurations (list)

A list of remediation configuration objects.

JSON Syntax:

[
  {
    "ConfigRuleName": "string",
    "TargetType": "SSM_DOCUMENT",
    "TargetId": "string",
    "TargetVersion": "string",
    "Parameters": {"string": {
          "ResourceValue": {
            "Value": "RESOURCE_ID"
          },
          "StaticValue": {
            "Values": ["string", ...]
          }
        }
      ...},
    "ResourceType": "string"
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

FailedBatches -> (list)

Returns a list of failed remediation batch objects.

(structure)

List of each of the failed remediations with specific reasons.

FailureMessage -> (string)

Returns a failure message. For example, the resource is already compliant.

FailedItems -> (list)

Returns remediation configurations of the failed items.

(structure)

An object that represents the details about the remediation configuration that includes the remediation action, parameters, and data to execute the action.

ConfigRuleName -> (string)

The name of the AWS Config rule.

TargetType -> (string)

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

TargetId -> (string)

Target ID is the name of the public document.

TargetVersion -> (string)

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

Parameters -> (map)

An object of the RemediationParameterValue.

key -> (string)

value -> (structure)

The value is either a dynamic (resource) value or a static value. You must select either a dynamic value or a static value.

ResourceValue -> (structure)

The value is dynamic and changes at run-time.

Value -> (string)

The value is a resource ID.

StaticValue -> (structure)

The value is static and does not change at run-time.

Values -> (list)

A list of values. For example, the ARN of the assumed role.

(string)

ResourceType -> (string)

The type of a resource.