Menu
AWS Config
API Reference (API Version 2014-11-12)

PutDeliveryChannel

Creates a delivery channel object to deliver configuration information to an Amazon S3 bucket and Amazon SNS topic.

Before you can create a delivery channel, you must create a configuration recorder.

You can use this action to change the Amazon S3 bucket or an Amazon SNS topic of the existing delivery channel. To change the Amazon S3 bucket or an Amazon SNS topic, call this action and specify the changed values for the S3 bucket and the SNS topic. If you specify a different value for either the S3 bucket or the SNS topic, this action will keep the existing value for the parameter that is not changed.

Note

You can have only one delivery channel per region in your account.

Request Syntax

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

The configuration delivery channel object that delivers the configuration information to an Amazon S3 bucket, and to an Amazon SNS topic.

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 permit 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

InvalidSNSTopicARNException

The specified Amazon SNS topic does not exist.

HTTP Status Code: 400

MaxNumberOfDeliveryChannelsExceededException

You have reached the limit on the number of delivery channels you can create.

HTTP Status Code: 400

NoAvailableConfigurationRecorderException

There are no configuration recorders available to provide the role needed to describe your resources. Create a configuration recorder.

HTTP Status Code: 400

NoSuchBucketException

The specified Amazon S3 bucket does not exist.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: