1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. configuration
  6. DeliveryChannel

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.78.0
published on Monday, Sep 7, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.78.0
published on Monday, Sep 7, 2026 by Pulumi

    Resource Type definition for AWS::Config::DeliveryChannel

    Create DeliveryChannel Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DeliveryChannel(name: string, args: DeliveryChannelArgs, opts?: CustomResourceOptions);
    @overload
    def DeliveryChannel(resource_name: str,
                        args: DeliveryChannelArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def DeliveryChannel(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        s3_bucket_name: Optional[str] = None,
                        config_snapshot_delivery_properties: Optional[DeliveryChannelConfigSnapshotDeliveryPropertiesArgs] = None,
                        name: Optional[str] = None,
                        s3_key_prefix: Optional[str] = None,
                        s3_kms_key_arn: Optional[str] = None,
                        sns_topic_arn: Optional[str] = None)
    func NewDeliveryChannel(ctx *Context, name string, args DeliveryChannelArgs, opts ...ResourceOption) (*DeliveryChannel, error)
    public DeliveryChannel(string name, DeliveryChannelArgs args, CustomResourceOptions? opts = null)
    public DeliveryChannel(String name, DeliveryChannelArgs args)
    public DeliveryChannel(String name, DeliveryChannelArgs args, CustomResourceOptions options)
    
    type: aws-native:configuration:DeliveryChannel
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_configuration_delivery_channel" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args DeliveryChannelArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DeliveryChannelArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DeliveryChannelArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DeliveryChannelArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DeliveryChannelArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    DeliveryChannel Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The DeliveryChannel resource accepts the following input properties:

    S3BucketName string

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    ConfigSnapshotDeliveryProperties Pulumi.AwsNative.Configuration.Inputs.DeliveryChannelConfigSnapshotDeliveryProperties
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    Name string

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    S3KeyPrefix string
    The prefix for the specified Amazon S3 bucket.
    S3KmsKeyArn string
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    SnsTopicArn string

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    S3BucketName string

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    ConfigSnapshotDeliveryProperties DeliveryChannelConfigSnapshotDeliveryPropertiesArgs
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    Name string

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    S3KeyPrefix string
    The prefix for the specified Amazon S3 bucket.
    S3KmsKeyArn string
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    SnsTopicArn string

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    s3_bucket_name string

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    config_snapshot_delivery_properties object
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    name string

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    s3_key_prefix string
    The prefix for the specified Amazon S3 bucket.
    s3_kms_key_arn string
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    sns_topic_arn string

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    s3BucketName String

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    configSnapshotDeliveryProperties DeliveryChannelConfigSnapshotDeliveryProperties
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    name String

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    s3KeyPrefix String
    The prefix for the specified Amazon S3 bucket.
    s3KmsKeyArn String
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    snsTopicArn String

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    s3BucketName string

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    configSnapshotDeliveryProperties DeliveryChannelConfigSnapshotDeliveryProperties
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    name string

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    s3KeyPrefix string
    The prefix for the specified Amazon S3 bucket.
    s3KmsKeyArn string
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    snsTopicArn string

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    s3_bucket_name str

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    config_snapshot_delivery_properties DeliveryChannelConfigSnapshotDeliveryPropertiesArgs
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    name str

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    s3_key_prefix str
    The prefix for the specified Amazon S3 bucket.
    s3_kms_key_arn str
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    sns_topic_arn str

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    s3BucketName String

    The name of the Amazon S3 bucket to which AWS Config delivers configuration snapshots and configuration history files.

    If you specify a bucket that belongs to another AWS account , that bucket must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon S3 Bucket in the AWS Config Developer Guide .

    configSnapshotDeliveryProperties Property Map
    The options for how often AWS Config delivers configuration snapshots to the Amazon S3 bucket.
    name String

    A name for the delivery channel. If you don't specify a name, CloudFormation generates a unique physical ID and uses that ID for the delivery channel name. For more information, see Name Type .

    Updates are not supported. To change the name, you must run two separate updates. In the first update, delete this resource, and then recreate it with a new name in the second update.

    s3KeyPrefix String
    The prefix for the specified Amazon S3 bucket.
    s3KmsKeyArn String
    The Amazon Resource Name (ARN) of the AWS Key Management Service ( AWS ) AWS KMS key (KMS key) used to encrypt objects delivered by AWS Config . Must belong to the same Region as the destination S3 bucket.
    snsTopicArn String

    The Amazon Resource Name (ARN) of the Amazon SNS topic to which AWS Config sends notifications about configuration changes.

    If you choose a topic from another account, the topic must have policies that grant access permissions to AWS Config . For more information, see Permissions for the Amazon SNS Topic in the AWS Config Developer Guide .

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DeliveryChannel resource produces the following output properties:

    AwsId string
    Id string
    The provider-assigned unique ID for this managed resource.
    AwsId string
    Id string
    The provider-assigned unique ID for this managed resource.
    aws_id string
    id string
    The provider-assigned unique ID for this managed resource.
    awsId String
    id String
    The provider-assigned unique ID for this managed resource.
    awsId string
    id string
    The provider-assigned unique ID for this managed resource.
    aws_id str
    id str
    The provider-assigned unique ID for this managed resource.
    awsId String
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    DeliveryChannelConfigSnapshotDeliveryProperties, DeliveryChannelConfigSnapshotDeliveryPropertiesArgs

    DeliveryFrequency string
    The frequency with which AWS Config delivers configuration snapshots.
    DeliveryFrequency string
    The frequency with which AWS Config delivers configuration snapshots.
    delivery_frequency string
    The frequency with which AWS Config delivers configuration snapshots.
    deliveryFrequency String
    The frequency with which AWS Config delivers configuration snapshots.
    deliveryFrequency string
    The frequency with which AWS Config delivers configuration snapshots.
    delivery_frequency str
    The frequency with which AWS Config delivers configuration snapshots.
    deliveryFrequency String
    The frequency with which AWS Config delivers configuration snapshots.

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.78.0
    published on Monday, Sep 7, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial