# PutDeliveryChannel
<a name="API_PutDeliveryChannel"></a>

Creates or updates a delivery channel to deliver configuration information and other compliance information.

You can use this operation to create a new delivery channel or to update the Amazon S3 bucket and the Amazon SNS topic of an existing delivery channel.

For more information, see [https://docs.amazonaws.cn/config/latest/developerguide/manage-delivery-channel.html](https://docs.amazonaws.cn/config/latest/developerguide/manage-delivery-channel.html) in the * Amazon Config Developer Guide.* 

**Note**  
 **One delivery channel per account per Region**   
You can have only one delivery channel for each account for each Amazon Web Services Region.  
 Delivery channel cannot be cross-Region for the China (Beijing) Region  
 In the China (Beijing) Region, when you call this operation, the Amazon S3 bucket must also be in the China (Beijing) Region. In all the other regions, Amazon Config supports cross-Region and cross-account delivery channels.

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

```
{
   "DeliveryChannel": { 
      "configSnapshotDeliveryProperties": { 
         "deliveryFrequency": "{{string}}"
      },
      "name": "{{string}}",
      "s3BucketName": "{{string}}",
      "s3KeyPrefix": "{{string}}",
      "s3KmsKeyArn": "{{string}}",
      "snsTopicARN": "{{string}}"
   }
}
```

## Request Parameters
<a name="API_PutDeliveryChannel_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.

 ** [DeliveryChannel](#API_PutDeliveryChannel_RequestSyntax) **   <a name="config-PutDeliveryChannel-request-DeliveryChannel"></a>
An object for the delivery channel. A delivery channel sends notifications and updated configuration states.   
Type: [DeliveryChannel](API_DeliveryChannel.md) object  
Required: Yes

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

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

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

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

 ** InsufficientDeliveryPolicyException **   
Your Amazon S3 bucket policy does not allow Amazon Config to write to it.  
HTTP Status Code: 400

 ** InvalidDeliveryChannelNameException **   
The specified delivery channel name is not valid.  
HTTP Status Code: 400

 ** InvalidS3KeyPrefixException **   
The specified Amazon S3 key prefix is not valid.  
HTTP Status Code: 400

 ** InvalidS3KmsKeyArnException **   
The specified Amazon KMS Key ARN is not valid.  
HTTP Status Code: 400

 ** InvalidSNSTopicARNException **   
The specified Amazon SNS topic does not exist.  
HTTP Status Code: 400

 ** MaxNumberOfDeliveryChannelsExceededException **   
You have reached the limit of the number of delivery channels you can create.  
HTTP Status Code: 400

 ** NoAvailableConfigurationRecorderException **   
There are no customer managed configuration recorders available to record your resources. Use the [PutConfigurationRecorder](https://docs.amazonaws.cn/config/latest/APIReference/API_PutConfigurationRecorder.html) operation to create the customer managed configuration recorder.  
HTTP Status Code: 400

 ** NoSuchBucketException **   
The specified Amazon S3 bucket does not exist.  
HTTP Status Code: 400

## See Also
<a name="API_PutDeliveryChannel_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/PutDeliveryChannel) 
+  [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for C\+\+](https://docs.amazonaws.cn/goto/SdkForCpp/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/config-2014-11-12/PutDeliveryChannel) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/config-2014-11-12/PutDeliveryChannel)