Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

DisassociateResourceTypes

Removes all resource types specified in the ResourceTypes list from the RecordingGroup of configuration recorder and excludes these resource types when recording.

For this operation, the configuration recorder must use a RecordingStrategy that is either INCLUSION_BY_RESOURCE_TYPES or EXCLUSION_BY_RESOURCE_TYPES.

Request Syntax


{
   "ConfigurationRecorderArn": "string",
   "ResourceTypes": [ "string" ]
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

ConfigurationRecorderArn

The Amazon Resource Name (ARN) of the specified configuration recorder.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1000.

Required: Yes

ResourceTypes

The list of resource types you want to remove from the recording group of the specified configuration recorder.

Type: Array of strings

Required: Yes

Response Syntax


{
   "ConfigurationRecorder": { 
      "arn": "string",
      "name": "string",
      "recordingGroup": { 
         "allSupported": boolean,
         "exclusionByResourceTypes": { 
            "resourceTypes": [ "string" ]
         },
         "includeGlobalResourceTypes": boolean,
         "recordingStrategy": { 
            "useOnly": "string"
         },
         "resourceTypes": [ "string" ]
      },
      "recordingMode": { 
         "recordingFrequency": "string",
         "recordingModeOverrides": [ 
            { 
               "description": "string",
               "recordingFrequency": "string",
               "resourceTypes": [ "string" ]
            }
         ]
      },
      "recordingScope": "string",
      "roleARN": "string",
      "servicePrincipal": "string"
   }
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

ConfigurationRecorder

Records configuration changes to the resource types in scope.

For more information about the configuration recorder, see Working with the Configuration Recorder in the AWS Config Developer Guide.

Type: ConfigurationRecorder object

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

For PutServiceLinkedConfigurationRecorder, you cannot create a service-linked recorder because a service-linked recorder already exists for the specified service.

For DeleteServiceLinkedConfigurationRecorder, you cannot delete the service-linked recorder because it is currently in use by the linked AWS service.

For DeleteDeliveryChannel, you cannot delete the specified delivery channel because the customer managed configuration recorder is running. Use the StopConfigurationRecorder operation to stop the customer managed configuration recorder.

For AssociateResourceTypes and DisassociateResourceTypes, one of the following errors:

For service-linked configuration recorders, the configuration recorder is not in use by the service. No association or dissociation of resource types is permitted.
For service-linked configuration recorders, your requested change to the configuration recorder has been denied by its linked AWS service.

HTTP Status Code: 400

NoSuchConfigurationRecorderException

You have specified a configuration recorder that does not exist.

HTTP Status Code: 400

ValidationException

The requested operation is not valid. You will see this exception if there are missing required fields or if the input value fails the validation.

For PutStoredQuery, one of the following errors:

There are missing required fields.
The input value fails the validation.
You are trying to create more than 300 queries.

For DescribeConfigurationRecorders and DescribeConfigurationRecorderStatus, one of the following errors:

You have specified more than one configuration recorder.
You have provided a service principal for service-linked configuration recorder that is not valid.

For AssociateResourceTypes and DisassociateResourceTypes, one of the following errors:

Your configuraiton recorder has a recording strategy that does not allow the association or disassociation of resource types.
One or more of the specified resource types are already associated or disassociated with the configuration recorder.
For service-linked configuration recorders, the configuration recorder does not record one or more of the specified resource types.

HTTP Status Code: 400