# DeleteServiceLinkedConfigurationRecorder
<a name="API_DeleteServiceLinkedConfigurationRecorder"></a>

Deletes an existing service-linked configuration recorder.

This operation does not delete the configuration information that was previously recorded. You will be able to access the previously recorded information by using the [GetResourceConfigHistory](https://docs.amazonaws.cn/config/latest/APIReference/API_GetResourceConfigHistory.html) operation, but you will not be able to access this information in the Amazon Config console until you have created a new service-linked configuration recorder for the same service.

**Note**  
 **The recording scope determines if you receive configuration items**   
The recording scope is set by the service that is linked to the configuration recorder and determines whether you receive configuration items (CIs) in the delivery channel. If the recording scope is internal, you will not receive CIs in the delivery channel.

## Request Syntax
<a name="API_DeleteServiceLinkedConfigurationRecorder_RequestSyntax"></a>

```
{
   "ServicePrincipal": "string"
}
```

## Request Parameters
<a name="API_DeleteServiceLinkedConfigurationRecorder_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [ServicePrincipal](#API_DeleteServiceLinkedConfigurationRecorder_RequestSyntax) **   <a name="config-DeleteServiceLinkedConfigurationRecorder-request-ServicePrincipal"></a>
The service principal of the Amazon Web Services service for the service-linked configuration recorder that you want to delete.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[\w+=,.@-]+`   
Required: Yes

## Response Syntax
<a name="API_DeleteServiceLinkedConfigurationRecorder_ResponseSyntax"></a>

```
{
   "Arn": "string",
   "Name": "string"
}
```

## Response Elements
<a name="API_DeleteServiceLinkedConfigurationRecorder_ResponseElements"></a>

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

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

 ** [Arn](#API_DeleteServiceLinkedConfigurationRecorder_ResponseSyntax) **   <a name="config-DeleteServiceLinkedConfigurationRecorder-response-Arn"></a>
The Amazon Resource Name (ARN) of the specified configuration recorder.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 1000.

 ** [Name](#API_DeleteServiceLinkedConfigurationRecorder_ResponseSyntax) **   <a name="config-DeleteServiceLinkedConfigurationRecorder-response-Name"></a>
The name of the specified configuration recorder.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 256.

## Errors
<a name="API_DeleteServiceLinkedConfigurationRecorder_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** ConflictException **   
For [PutServiceLinkedConfigurationRecorder](https://docs.amazonaws.cn/config/latest/APIReference/API_PutServiceLinkedConfigurationRecorder.html), you cannot create a service-linked recorder because a service-linked recorder already exists for the specified service.  
For [DeleteServiceLinkedConfigurationRecorder](https://docs.amazonaws.cn/config/latest/APIReference/API_DeleteServiceLinkedConfigurationRecorder.html), you cannot delete the service-linked recorder because it is currently in use by the linked Amazon Web Services service.  
For [DeleteDeliveryChannel](https://docs.amazonaws.cn/config/latest/APIReference/API_DeleteDeliveryChannel.html), you cannot delete the specified delivery channel because the customer managed configuration recorder is running. Use the [StopConfigurationRecorder](https://docs.amazonaws.cn/config/latest/APIReference/API_StopConfigurationRecorder.html) operation to stop the customer managed configuration recorder.  
For [AssociateResourceTypes](https://docs.amazonaws.cn/config/latest/APIReference/API_AssociateResourceTypes.html) and [DisassociateResourceTypes](https://docs.amazonaws.cn/config/latest/APIReference/API_DisassociateResourceTypes.html), 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 Amazon Web Services 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](https://docs.amazonaws.cn/config/latest/APIReference/API_PutStoredQuery.html), 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](https://docs.amazonaws.cn/config/latest/APIReference/API_DescribeConfigurationRecorders.html) and [DescribeConfigurationRecorderStatus](https://docs.amazonaws.cn/config/latest/APIReference/API_DescribeConfigurationRecorderStatus.html), 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](https://docs.amazonaws.cn/config/latest/APIReference/API_AssociateResourceTypes.html) and [DisassociateResourceTypes](https://docs.amazonaws.cn/config/latest/APIReference/API_DisassociateResourceTypes.html), 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

## See Also
<a name="API_DeleteServiceLinkedConfigurationRecorder_SeeAlso"></a>

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/config-2014-11-12/DeleteServiceLinkedConfigurationRecorder)