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::Pipes::Pipe S3LogDestination
<a name="aws-properties-pipes-pipe-s3logdestination"></a>

Represents the Amazon S3 logging configuration settings for the pipe.

## Syntax
<a name="aws-properties-pipes-pipe-s3logdestination-syntax"></a>

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

### JSON
<a name="aws-properties-pipes-pipe-s3logdestination-syntax.json"></a>

```
{
  "[BucketName](#cfn-pipes-pipe-s3logdestination-bucketname)" : {{String}},
  "[BucketOwner](#cfn-pipes-pipe-s3logdestination-bucketowner)" : {{String}},
  "[OutputFormat](#cfn-pipes-pipe-s3logdestination-outputformat)" : {{String}},
  "[Prefix](#cfn-pipes-pipe-s3logdestination-prefix)" : {{String}}
}
```

### YAML
<a name="aws-properties-pipes-pipe-s3logdestination-syntax.yaml"></a>

```
  [BucketName](#cfn-pipes-pipe-s3logdestination-bucketname): {{String}}
  [BucketOwner](#cfn-pipes-pipe-s3logdestination-bucketowner): {{String}}
  [OutputFormat](#cfn-pipes-pipe-s3logdestination-outputformat): {{String}}
  [Prefix](#cfn-pipes-pipe-s3logdestination-prefix): {{String}}
```

## Properties
<a name="aws-properties-pipes-pipe-s3logdestination-properties"></a>

`BucketName`  <a name="cfn-pipes-pipe-s3logdestination-bucketname"></a>
The name of the Amazon S3 bucket to which EventBridge delivers the log records for the pipe.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`BucketOwner`  <a name="cfn-pipes-pipe-s3logdestination-bucketowner"></a>
The Amazon account that owns the Amazon S3 bucket to which EventBridge delivers the log records for the pipe.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`OutputFormat`  <a name="cfn-pipes-pipe-s3logdestination-outputformat"></a>
The format EventBridge uses for the log records.  
EventBridge currently only supports `json` formatting.  
*Required*: No  
*Type*: String  
*Allowed values*: `json | plain | w3c`  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Prefix`  <a name="cfn-pipes-pipe-s3logdestination-prefix"></a>
The prefix text with which to begin Amazon S3 log object names.  
For more information, see [Organizing objects using prefixes](https://docs.amazonaws.cn/AmazonS3/latest/userguide/using-prefixes.html) in the *Amazon Simple Storage Service User Guide*.  
*Required*: No  
*Type*: String  
*Update requires*: [No interruption](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)