> **Experimental**
>
> `@aws-cdk/aws-pipes-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# S3LogDestinationProps

Properties for `S3LogDestination`.

Used as props by: [S3LogDestination](/cdk/api/v2/docs/@aws-cdk_aws-pipes-alpha.S3LogDestination.html)

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/logs.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-pipes-alpha/lib/logs.ts#L66)

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as pipes_alpha from '@aws-cdk/aws-pipes-alpha';
import { aws_s3 as s3 } from 'aws-cdk-lib';

declare const bucket: s3.Bucket;
const s3LogDestinationProps: pipes_alpha.S3LogDestinationProps = {
  bucket: bucket,

  // the properties below are optional
  bucketOwner: 'bucketOwner',
  outputFormat: pipes_alpha.S3OutputFormat.PLAIN,
  prefix: 'prefix',
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_pipes_alpha as pipes_alpha
from aws_cdk import aws_s3 as s3

# bucket: s3.Bucket

s3_log_destination_props = pipes_alpha.S3LogDestinationProps(
    bucket=bucket,

    # the properties below are optional
    bucket_owner="bucketOwner",
    output_format=pipes_alpha.S3OutputFormat.PLAIN,
    prefix="prefix"
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.pipes.alpha.*;
import software.amazon.awscdk.services.s3.*;

Bucket bucket;

S3LogDestinationProps s3LogDestinationProps = S3LogDestinationProps.builder()
        .bucket(bucket)

        // the properties below are optional
        .bucketOwner("bucketOwner")
        .outputFormat(S3OutputFormat.PLAIN)
        .prefix("prefix")
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.Pipes.Alpha
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Pipes.Alpha;
using Amazon.CDK.AWS.S3;

Bucket bucket;

var s3LogDestinationProps = new S3LogDestinationProps {
    Bucket = bucket,

    // the properties below are optional
    BucketOwner = "bucketOwner",
    OutputFormat = S3OutputFormat.PLAIN,
    Prefix = "prefix"
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdkpipesalpha/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import pipes_alpha "github.com/aws/aws-cdk-go/awscdkpipesalpha"
import "github.com/aws/aws-cdk-go/awscdk"

var bucket Bucket

s3LogDestinationProps := &S3LogDestinationProps{
	Bucket: bucket,

	// the properties below are optional
	BucketOwner: jsii.String("bucketOwner"),
	OutputFormat: pipes_alpha.S3OutputFormat_PLAIN,
	Prefix: jsii.String("prefix"),
}
```

## Properties

- `bucket`: [IBucket](/cdk/api/v2/docs/aws-cdk-lib.aws_s3.IBucket.html) (required) — The S3 bucket to deliver the log records for the pipe.

  The bucket can be in the same or a different AWS Account. If the bucket is in
  a different account, specify `bucketOwner`. You must also allow access to the
  Pipes role in the bucket policy of the cross-account bucket.

- `bucketOwner`: string — The AWS Account that owns the Amazon S3 bucket to which EventBridge delivers the log records for the pipe.

  **Default:** account ID derived from `bucket`

- `outputFormat`: [S3OutputFormat](/cdk/api/v2/docs/@aws-cdk_aws-pipes-alpha.S3OutputFormat.html) = `S3OutputFormat.JSON` — The format for the log records.

- `prefix`: string — The prefix text with which to begin Amazon S3 log object names.

  **Default:** no prefix
