/

POST

Creates a new configuration recorder to record the selected resource configurations.

You can use this action to change the role roleARN or the recordingGroup of an existing recorder. To change the role, call the action on the existing configuration recorder and specify a role.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ConfigurationRecorder": {
        "name": "string",
        "roleARN": "string",
        "recordingGroup": {}
    }
}'

Response Example

200 - Example 1

{}

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

The input for the <a>PutConfigurationRecorder</a> action.

ConfigurationRecorder

object

required

The configuration recorder object that records each configuration change made to the resources.

name

string

optional

The name of the recorder. By default, Config automatically assigns the name "default" when creating the configuration recorder. You cannot change the assigned name.

>= 1 characters<= 256 characters

roleARN

string

optional

Amazon Resource Name (ARN) of the IAM role used to describe the Amazon Web Services resources associated with the account.

recordingGroup

object

optional

Specifies the types of Amazon Web Services resources for which Config records configuration changes.

Examples

Responses

🟢200Success

application/json

Body

object {0}

🟠480MaxNumberOfConfigurationRecordersExceededException

🟠481InvalidConfigurationRecorderNameException

🟠482InvalidRoleException

🟠483InvalidRecordingGroupException

Modified at 2023-08-15 05:59:06