# S3LoggingOptions

Information about logs built to an S3 bucket for a build project.

- Source: [`aws-codebuild/lib/project-logs.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-codebuild/lib/project-logs.ts#L7)

## Example

TypeScript:

```ts
new codebuild.Project(this, 'Project', {
  logging: {
    s3: {
      bucket: new s3.Bucket(this, `LogBucket`)
    }
  },
})
```

Python:

```python
codebuild.Project(self, "Project",
    logging=codebuild.LoggingOptions(
        s3=codebuild.S3LoggingOptions(
            bucket=s3.Bucket(self, "LogBucket")
        )
    )
)
```

Java:

```java
Project.Builder.create(this, "Project")
        .logging(LoggingOptions.builder()
                .s3(S3LoggingOptions.builder()
                        .bucket(new Bucket(this, "LogBucket"))
                        .build())
                .build())
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
new Project(this, "Project", new ProjectProps {
    Logging = new LoggingOptions {
        S3 = new S3LoggingOptions {
            Bucket = new Bucket(this, "LogBucket")
        }
    }
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
codebuild.NewProject(this, jsii.String("Project"), &ProjectProps{
	Logging: &LoggingOptions{
		S3: &S3LoggingOptions{
			Bucket: s3.NewBucket(this, jsii.String("LogBucket")),
		},
	},
})
```

## Properties

- `bucket`: [IBucket](/cdk/api/v2/docs/aws-cdk-lib.aws_s3.IBucket.html) (required) — The S3 Bucket to send logs to.

- `enabled`: boolean = true — The current status of the logs in Amazon CloudWatch Logs for a build project.

- `encrypted`: boolean = true — Encrypt the S3 build log output.

- `prefix`: string — The path prefix for S3 logs.

  **Default:** no prefix
