This is the new *Amazon CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [Amazon CloudFormation User Guide](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::S3::Bucket EventBridgeConfiguration
<a name="aws-properties-s3-bucket-eventbridgeconfiguration"></a>

Amazon S3 can send events to Amazon EventBridge whenever certain events happen in your bucket, see [Using EventBridge](https://docs.amazonaws.cn/AmazonS3/latest/userguide/EventBridge.html) in the *Amazon S3 User Guide*.

Unlike other destinations, delivery of events to EventBridge can be either enabled or disabled for a bucket. If enabled, all events will be sent to EventBridge and you can use EventBridge rules to route events to additional targets. For more information, see [What Is Amazon EventBridge](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-what-is.html) in the *Amazon EventBridge User Guide*

## Syntax
<a name="aws-properties-s3-bucket-eventbridgeconfiguration-syntax"></a>

To declare this entity in your Amazon CloudFormation template, use the following syntax:

### JSON
<a name="aws-properties-s3-bucket-eventbridgeconfiguration-syntax.json"></a>

```
{
  "[EventBridgeEnabled](#cfn-s3-bucket-eventbridgeconfiguration-eventbridgeenabled)" : {{Boolean}}
}
```

### YAML
<a name="aws-properties-s3-bucket-eventbridgeconfiguration-syntax.yaml"></a>

```
  [EventBridgeEnabled](#cfn-s3-bucket-eventbridgeconfiguration-eventbridgeenabled): {{Boolean}}
```

## Properties
<a name="aws-properties-s3-bucket-eventbridgeconfiguration-properties"></a>

`EventBridgeEnabled`  <a name="cfn-s3-bucket-eventbridgeconfiguration-eventbridgeenabled"></a>
Enables delivery of events to Amazon EventBridge.  
*Required*: Yes  
*Type*: Boolean  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

## Examples
<a name="aws-properties-s3-bucket-eventbridgeconfiguration--examples"></a>



### Enable EventBridgeConfiguration
<a name="aws-properties-s3-bucket-eventbridgeconfiguration--examples--Enable_EventBridgeConfiguration"></a>

The following example template shows an Amazon S3 bucket with a notification configuration with EventBridge enabled.

#### JSON
<a name="aws-properties-s3-bucket-eventbridgeconfiguration--examples--Enable_EventBridgeConfiguration--json"></a>

```
{
"Resources": {
  "S3Bucket": {
    "Type": "AWS::S3::Bucket",
    "Properties": {
      "NotificationConfiguration": {
        "EventBridgeConfiguration": {
          "EventBridgeEnabled": true
          }
        }
      }
    }
  }
}
```

#### YAML
<a name="aws-properties-s3-bucket-eventbridgeconfiguration--examples--Enable_EventBridgeConfiguration--yaml"></a>

```
Resources:
  S3Bucket:
    Type: 'AWS::S3::Bucket'
    Properties:
      NotificationConfiguration:
        EventBridgeConfiguration:
          EventBridgeEnabled: true
```