Request Syntax Request Parameters Response Elements Errors See Also

PutDeliveryChannel

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 Working with the Delivery Channel in the AWS Config Developer Guide.

Note

One delivery channel per account per Region

You can have only one delivery channel for each account for each AWS Region.

Request Syntax


{
   "DeliveryChannel": { 
      "configSnapshotDeliveryProperties": { 
         "deliveryFrequency": "string"
      },
      "name": "string",
      "s3BucketName": "string",
      "s3KeyPrefix": "string",
      "s3KmsKeyArn": "string",
      "snsTopicARN": "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.

DeliveryChannel

An object for the delivery channel. A delivery channel sends notifications and updated configuration states.

Type: DeliveryChannel object

Required: Yes

Response Elements

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

Errors

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

InsufficientDeliveryPolicyException

Your Amazon S3 bucket policy does not allow AWS 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 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