Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Updating a default event bus using AWS CloudFormation in EventBridge

Focus mode
Updating a default event bus using AWS CloudFormation in EventBridge - Amazon EventBridge

AWS CloudFormation enables you to configure and manage your AWS resources across accounts and regions in a centralized and repeatable manner by treating infrastructure as code. CloudFormation does this by letting you create templates, which define the resources you want to provision and manage.

Because EventBridge provisions the default event bus into your account automatically, you cannot create it using a CloudFormation template, as you normally would for any resource you wanted to include in a CloudFormation stack. To include the default event bus in a CloudFormation stack, you must first import it into a stack. Once you have imported the default event bus into a stack, you can then update the event bus properties as desired.

To import an existing resource into a new or existing CloudFormation stack, you need the following information:

  • A unique identifier for the resource to import.

    For default event buses, the identifier is Name and then identifier value is default.

  • A template that accurately describes the current properties of the existing resource.

    The template snippet below contains an AWS::Events::EventBus resource that describes the current properties of a default event bus. In this example, the event bus has been configured to use a customer managed key and DLQ for encryption at rest.

    Also, the AWS::Events::EventBus resource that describes the default event bus you want to import should include a DeletionPolicy property set to Retain.

    { "AWSTemplateFormatVersion": "2010-09-09", "Description": "Default event bus import example", "Resources": { "defaultEventBus": { "Type" : "AWS::Events::EventBus", "DeletionPolicy": "Retain", "Properties" : { "Name" : "default", "KmsKeyIdentifier" : "KmsKeyArn", "DeadLetterConfig" : { "Arn" : "DLQ_ARN" } } } } }

For more information, see Bringing existing resources into CloudFormation management in the CloudFormation User Guide.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.