# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/aws/aws.s3_bucket.dataset.md

---
title: S3 Bucket
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > S3 Bucket
---

# S3 Bucket

An S3 Bucket is a storage container in Amazon Web Services used to store and organize objects such as files, backups, and data. It provides scalable, durable, and secure storage with features like versioning, lifecycle policies, and access controls. Buckets serve as the top-level namespace for S3 objects and can be configured for public or private access, encryption, and cross-region replication.

```
aws.s3_bucket
```

## Fields

| Title                                  | ID   | Type       | Data Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Description |
| -------------------------------------- | ---- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| _key                                   | core | string     |
| account_id                             | core | string     |
| bucket_arn                             | core | string     | The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely identify Amazon Web Services resources across all of Amazon Web Services. This parameter is only supported for S3 directory buckets. For more information, see Using tags with directory buckets.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| bucket_policy_statement                | core | json       |
| bucket_region                          | core | string     | BucketRegion indicates the Amazon Web Services region where the bucket is located. If the request contains at least one valid parameter, it is included in the response.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| bucket_versioning                      | core | json       |
| bucket_website                         | core | json       |
| creation_date                          | core | timestamp  | Date the bucket was created. This date can change when making changes to your bucket, such as editing its bucket policy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| grants                                 | core | json       | A list of grants.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| inventory_configuration_list           | core | json       | The list of inventory configurations for a bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| location_constraint                    | core | string     | Specifies the Region where the bucket resides. For a list of all the Amazon S3 supported location constraints by Region, see Regions and Endpoints. Buckets in Region us-east-1 have a LocationConstraint of null. Buckets with a LocationConstraint of EU reside in eu-west-1.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| logging_enabled                        | core | json       | Describes where logs are stored and the prefix that Amazon S3 assigns to all log object keys for a bucket. For more information, see PUT Bucket logging in the Amazon S3 API Reference.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| name                                   | core | string     | The name of the bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| notification_configuration             | core | json       |
| owner                                  | core | json       | Container for the bucket owner's ID.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| policy                                 | core | string     | The bucket policy as a JSON document.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| policy_status                          | core | json       | The policy status for the specified bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| public_access_block_configuration      | core | json       | The PublicAccessBlock configuration currently in effect for this Amazon S3 bucket.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| replication_configuration              | core | json       | A container for replication rules. You can add up to 1,000 rules. The maximum size of a replication configuration is 2 MB.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| rules                                  | core | json       | Container for a lifecycle rule.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| server_side_encryption_configuration   | core | json       | Specifies the default server-side-encryption configuration.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| tags                                   | core | hstore_csv |
| transition_default_minimum_object_size | core | string     | Indicates which default minimum object size behavior is applied to the lifecycle configuration. This parameter applies to general purpose buckets only. It isn't supported for directory bucket lifecycle configurations. all_storage_classes_128K - Objects smaller than 128 KB will not transition to any storage class by default. varies_by_storage_class - Objects smaller than 128 KB will transition to Glacier Flexible Retrieval or Glacier Deep Archive storage classes. By default, all other storage classes will prevent transitions smaller than 128 KB. To customize the minimum object size for any transition you can add a filter that specifies a custom ObjectSizeGreaterThan or ObjectSizeLessThan in the body of your transition rule. Custom filters always take precedence over the default transition behavior. |