or run

npx @tessl/cli init

Version

Tile

Overview

Evals

Files

docs

bucket-access-control.md bucket-features.md bucket-operations.md client-config.md index.md list-operations.md multipart-upload.md object-operations.md paginators-waiters.md presigned-urls.md types.md

tile.json

AWS SDK for Go v2 - S3 Bucket Features and Configuration Operations

Package: github.com/aws/aws-sdk-go-v2/service/s3 Version: 1.92.1

This document provides comprehensive API reference for S3 bucket feature and configuration operations, organized by functional area.

Versioning
Tagging
CORS (Cross-Origin Resource Sharing)
Encryption
Lifecycle
Replication
Notifications
Website Hosting
Logging
Request Payment
Transfer Acceleration
Analytics
Metrics
Inventory
Intelligent-Tiering
Metadata Configuration

Versioning

GetBucketVersioning { .api }

Returns the versioning state of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketVersioning(ctx context.Context, params *GetBucketVersioningInput, optFns ...func(*Options)) (*GetBucketVersioningOutput, error)

Input Type: GetBucketVersioningInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The name of the bucket for which to get the versioning information
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: GetBucketVersioningOutput

Field	Type	Description
`MFADelete`	`types.MFADeleteStatus`	Specifies whether MFA delete is enabled. Only returned if the bucket has been configured with MFA delete
`Status`	`types.BucketVersioningStatus`	The versioning state of the bucket (Enabled, Suspended)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: To retrieve the versioning state of a bucket, you must be the bucket owner. This implementation also returns the MFA Delete status of the versioning state. If the MFA Delete status is enabled, the bucket owner must use an authentication device to change the versioning state of the bucket.

PutBucketVersioning { .api }

Sets the versioning state of an existing bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketVersioning(ctx context.Context, params *PutBucketVersioningInput, optFns ...func(*Options)) (*PutBucketVersioningOutput, error)

Input Type: PutBucketVersioningInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket name
`VersioningConfiguration`	`*types.VersioningConfiguration`	Yes	Container for setting the versioning state
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create the checksum for the request
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest of the data
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner
`MFA`	`*string`	No	Concatenation of authentication device's serial number, a space, and the value displayed on authentication device

VersioningConfiguration Type: types.VersioningConfiguration

Field	Type	Description
`MFADelete`	`types.MFADeleteStatus`	Specifies whether MFA delete is enabled in the bucket versioning configuration
`Status`	`types.BucketVersioningStatus`	The versioning state of the bucket (Enabled, Suspended)

Output Type: PutBucketVersioningOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: You can set the versioning state with one of the following values: Enabled (enables versioning for objects in the bucket, all objects receive a unique version ID) or Suspended (disables versioning, all objects receive the version ID null). When enabling versioning for the first time, it might take a short amount of time to propagate. Wait for 15 minutes after enabling before issuing write operations on objects in the bucket.

Tagging

GetBucketTagging { .api }

Returns the tag set associated with a general purpose bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketTagging(ctx context.Context, params *GetBucketTaggingInput, optFns ...func(*Options)) (*GetBucketTaggingOutput, error)

Input Type: GetBucketTaggingInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The name of the bucket for which to get the tagging information
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: GetBucketTaggingOutput

Field	Type	Description
`TagSet`	`[]types.Tag`	Contains the tag set
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Tag Type: types.Tag

Field	Type	Description
`Key`	`*string`	Name of the object key
`Value`	`*string`	Value of the tag

Description: Returns the tag set associated with the general purpose bucket if ABAC is not enabled. When you enable ABAC for a general purpose bucket, you can no longer use this operation and must use ListTagsForResource instead. Requires s3:GetBucketTagging permission.

Special Error:

Error code: NoSuchTagSet
Description: There is no tag set associated with the bucket

PutBucketTagging { .api }

Sets the tags for a general purpose bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketTagging(ctx context.Context, params *PutBucketTaggingInput, optFns ...func(*Options)) (*PutBucketTaggingOutput, error)

Input Type: PutBucketTaggingInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket name
`Tagging`	`*types.Tagging`	Yes	Container for the TagSet and Tag elements
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create the checksum for the request
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest of the data
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Tagging Type: types.Tagging

Field	Type	Description
`TagSet`	`[]types.Tag`	A collection for a set of tags

Output Type: PutBucketTaggingOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the tags for a general purpose bucket if ABAC is not enabled. When you enable ABAC, use TagResource or UntagResource instead. Use tags to organize your AWS bill to reflect your own cost structure. When this operation sets the tags for a bucket, it will overwrite any current tags the bucket already has. Requires s3:PutBucketTagging permission.

Special Errors:

InvalidTag: The tag provided was not valid
MalformedXML: The XML provided does not match the schema
OperationAborted: A conflicting conditional action is currently in progress
InternalError: The service was unable to apply the provided tag to the bucket

DeleteBucketTagging { .api }

Deletes tags from a general purpose bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketTagging(ctx context.Context, params *DeleteBucketTaggingInput, optFns ...func(*Options)) (*DeleteBucketTaggingOutput, error)

Input Type: DeleteBucketTaggingInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket that has the tag set to be removed
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: DeleteBucketTaggingOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes tags from the general purpose bucket if ABAC is not enabled. When you enable ABAC, use UntagResource instead. Requires s3:PutBucketTagging permission.

CORS (Cross-Origin Resource Sharing)

GetBucketCors { .api }

Returns the CORS configuration information set for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketCors(ctx context.Context, params *GetBucketCorsInput, optFns ...func(*Options)) (*GetBucketCorsOutput, error)

Input Type: GetBucketCorsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket name for which to get the CORS configuration. Can use access point alias or Object Lambda access point alias
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: GetBucketCorsOutput

Field	Type	Description
`CORSRules`	`[]types.CORSRule`	A set of origins and methods (cross-origin access that you want to allow). Can add up to 100 rules
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

CORSRule Type: types.CORSRule

Field	Type	Required	Description
`AllowedMethods`	`[]string`	Yes	HTTP methods that you allow the origin to execute (GET, PUT, HEAD, POST, DELETE)
`AllowedOrigins`	`[]string`	Yes	Origins you want customers to be able to access the bucket from
`AllowedHeaders`	`[]string`	No	Headers allowed in a preflight OPTIONS request
`ExposeHeaders`	`[]string`	No	Headers in the response that customers can access from their applications
`ID`	`*string`	No	Unique identifier for the rule (max 255 characters)
`MaxAgeSeconds`	`*int32`	No	Time in seconds that browser caches preflight response for the specified resource

Description: Returns the CORS configuration for the bucket. Requires s3:GetBucketCORS permission. By default, the bucket owner has this permission and can grant it to others.

PutBucketCors { .api }

Sets the CORS configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketCors(ctx context.Context, params *PutBucketCorsInput, optFns ...func(*Options)) (*PutBucketCorsOutput, error)

Input Type: PutBucketCorsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Specifies the bucket impacted by the CORS configuration
`CORSConfiguration`	`*types.CORSConfiguration`	Yes	Describes the cross-origin access configuration for objects in an S3 bucket
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create the checksum for the request
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest of the data
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

CORSConfiguration Type: types.CORSConfiguration

Field	Type	Required	Description
`CORSRules`	`[]types.CORSRule`	Yes	A set of origins and methods. Can add up to 100 rules

Output Type: PutBucketCorsOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the CORS configuration for the bucket. If configuration exists, S3 replaces it. The document is limited to 64 KB in size. When S3 receives a cross-origin request against a bucket, it evaluates the CORS configuration and uses the first CORSRule that matches. Requires s3:PutBucketCORS permission.

DeleteBucketCors { .api }

Deletes the CORS configuration information set for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketCors(ctx context.Context, params *DeleteBucketCorsInput, optFns ...func(*Options)) (*DeleteBucketCorsOutput, error)

Input Type: DeleteBucketCorsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Specifies the bucket whose CORS configuration is being deleted
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: DeleteBucketCorsOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the CORS configuration information set for the bucket. Requires s3:PutBucketCORS permission (same as Put operation).

Encryption

GetBucketEncryption { .api }

Returns the default encryption configuration for a bucket. Supported for both general purpose and directory buckets.

Method Signature:

func (c *Client) GetBucketEncryption(ctx context.Context, params *GetBucketEncryptionInput, optFns ...func(*Options)) (*GetBucketEncryptionOutput, error)

Input Type: GetBucketEncryptionInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket from which the server-side encryption configuration is retrieved. Directory buckets must use path-style requests
`ExpectedBucketOwner`	`*string`	No	Account ID of the expected bucket owner. Not supported for directory buckets

Output Type: GetBucketEncryptionOutput

Field	Type	Description
`ServerSideEncryptionConfiguration`	`*types.ServerSideEncryptionConfiguration`	Specifies the default server-side encryption configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

ServerSideEncryptionConfiguration Type: types.ServerSideEncryptionConfiguration

Field	Type	Description
`Rules`	`[]types.ServerSideEncryptionRule`	Container for information about a particular server-side encryption configuration rule

ServerSideEncryptionRule Type: types.ServerSideEncryptionRule

Field	Type	Description
`ApplyServerSideEncryptionByDefault`	`*types.ServerSideEncryptionByDefault`	Default server-side encryption to apply to new objects
`BucketKeyEnabled`	`*bool`	Specifies whether S3 Bucket Keys are enabled

ServerSideEncryptionByDefault Type: types.ServerSideEncryptionByDefault

Field	Type	Description
`SSEAlgorithm`	`types.ServerSideEncryption`	Server-side encryption algorithm (AES256, aws:kms, aws:kms:dsse)
`KMSMasterKeyID`	`*string`	AWS KMS key ID to use for default encryption

Description: By default, all buckets have a default encryption configuration that uses SSE-S3. This operation also returns BucketKeyEnabled and BlockedEncryptionTypes statuses. For directory buckets, only SSE-S3 and SSE-KMS are supported.

Permissions:

General purpose: Requires s3:GetEncryptionConfiguration permission
Directory buckets: Requires s3express:GetEncryptionConfiguration permission

PutBucketEncryption { .api }

Configures default encryption and S3 Bucket Keys for an existing bucket. Supported for both general purpose and directory buckets.

Method Signature:

func (c *Client) PutBucketEncryption(ctx context.Context, params *PutBucketEncryptionInput, optFns ...func(*Options)) (*PutBucketEncryptionOutput, error)

Input Type: PutBucketEncryptionInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name. Directory buckets must use path-style requests
`ServerSideEncryptionConfiguration`	`*types.ServerSideEncryptionConfiguration`	Yes	Specifies the default server-side encryption configuration
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum. For directory buckets, CRC32 is default
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest. Not supported for directory buckets
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner. Not supported for directory buckets

Output Type: PutBucketEncryptionOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: By default, all buckets have a default encryption configuration that uses SSE-S3. You can optionally configure SSE-KMS or DSSE-KMS for general purpose buckets. For directory buckets, you can optionally configure SSE-KMS. For directory buckets, SSE-KMS configuration can only support 1 customer managed key per bucket's lifetime. S3 Bucket Keys are always enabled for directory buckets.

Permissions:

General purpose: Requires s3:PutEncryptionConfiguration permission
Directory buckets: Requires s3express:PutEncryptionConfiguration, kms:GenerateDataKey, and kms:Decrypt permissions

DeleteBucketEncryption { .api }

Deletes the default encryption configuration for the bucket. Supported for both general purpose and directory buckets.

Method Signature:

func (c *Client) DeleteBucketEncryption(ctx context.Context, params *DeleteBucketEncryptionInput, optFns ...func(*Options)) (*DeleteBucketEncryptionOutput, error)

Input Type: DeleteBucketEncryptionInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket whose encryption configuration will be deleted. Directory buckets must use path-style requests
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner. Not supported for directory buckets

Output Type: DeleteBucketEncryptionOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Resets the default encryption for the bucket as SSE-S3. Requires s3:PutEncryptionConfiguration permission for general purpose buckets or s3express:PutEncryptionConfiguration for directory buckets.

Lifecycle

GetBucketLifecycleConfiguration { .api }

Returns the lifecycle configuration information set on the bucket.

Method Signature:

func (c *Client) GetBucketLifecycleConfiguration(ctx context.Context, params *GetBucketLifecycleConfigurationInput, optFns ...func(*Options)) (*GetBucketLifecycleConfigurationOutput, error)

Input Type: GetBucketLifecycleConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The name of the bucket for which to get the lifecycle information
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner. Not supported for directory buckets

Output Type: GetBucketLifecycleConfigurationOutput

Field	Type	Description
`Rules`	`[]types.LifecycleRule`	Container for a lifecycle rule
`TransitionDefaultMinimumObjectSize`	`types.TransitionDefaultMinimumObjectSize`	Indicates which default minimum object size behavior is applied (general purpose only)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

LifecycleRule Type: types.LifecycleRule

Field	Type	Required	Description
`Status`	`types.ExpirationStatus`	Yes	Rule status (Enabled, Disabled)
`AbortIncompleteMultipartUpload`	`*types.AbortIncompleteMultipartUpload`	No	Specifies days after which S3 aborts incomplete multipart uploads
`Expiration`	`*types.LifecycleExpiration`	No	Specifies expiration for object lifetime
`Filter`	`types.LifecycleRuleFilter`	No	Filter identifying subset of objects to which rule applies
`ID`	`*string`	No	Unique identifier for the rule (max 255 characters)
`NoncurrentVersionExpiration`	`*types.NoncurrentVersionExpiration`	No	Specifies when noncurrent objects expire
`NoncurrentVersionTransitions`	`[]types.NoncurrentVersionTransition`	No	Specifies transition of noncurrent objects to storage class
`Prefix`	`*string`	No	Object key prefix identifying objects to which rule applies (deprecated)
`Transitions`	`[]types.Transition`	No	Specifies when objects transition to specified storage class

LifecycleExpiration Type: types.LifecycleExpiration

Field	Type	Description
`Date`	`*time.Time`	Date when object expires
`Days`	`*int32`	Days after creation when object expires
`ExpiredObjectDeleteMarker`	`*bool`	Indicates whether S3 removes delete marker with no noncurrent versions

Description: Returns the lifecycle configuration information. Bucket lifecycle configuration now supports filtering based on object key name prefix, one or more object tags, object size, or any combination. Lifecycle configurations for directory buckets only support expiring objects and cancelling multipart uploads.

Permissions:

General purpose: Requires s3:GetLifecycleConfiguration permission
Directory buckets: Requires s3express:GetLifecycleConfiguration permission

Special Error:

Error code: NoSuchLifecycleConfiguration
Description: The lifecycle configuration does not exist
HTTP Status Code: 404 Not Found

PutBucketLifecycleConfiguration { .api }

Sets lifecycle configuration for a bucket.

Method Signature:

func (c *Client) PutBucketLifecycleConfiguration(ctx context.Context, params *PutBucketLifecycleConfigurationInput, optFns ...func(*Options)) (*PutBucketLifecycleConfigurationOutput, error)

Input Type: PutBucketLifecycleConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket for which to set the configuration
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner. Not supported for directory buckets
`LifecycleConfiguration`	`*types.BucketLifecycleConfiguration`	No	Container for lifecycle rules. Can add up to 1,000 rules
`TransitionDefaultMinimumObjectSize`	`types.TransitionDefaultMinimumObjectSize`	No	Default minimum object size behavior (general purpose only)

BucketLifecycleConfiguration Type: types.BucketLifecycleConfiguration

Field	Type	Description
`Rules`	`[]types.LifecycleRule`	Lifecycle configuration rules

Output Type: PutBucketLifecycleConfigurationOutput

Field	Type	Description
`TransitionDefaultMinimumObjectSize`	`types.TransitionDefaultMinimumObjectSize`	Default minimum object size behavior (general purpose only)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets lifecycle configuration for a bucket. Replaces existing lifecycle configuration if it exists. Maximum size is 2 MB. For directory buckets, only expiring objects and cancelling multipart uploads are supported.

Permissions:

General purpose: Requires s3:PutLifecycleConfiguration permission
Directory buckets: Requires s3express:PutLifecycleConfiguration permission

DeleteBucketLifecycle { .api }

Deletes the lifecycle configuration from the bucket.

Method Signature:

func (c *Client) DeleteBucketLifecycle(ctx context.Context, params *DeleteBucketLifecycleInput, optFns ...func(*Options)) (*DeleteBucketLifecycleOutput, error)

Input Type: DeleteBucketLifecycleInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket name of the lifecycle to delete
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner. Not supported for directory buckets

Output Type: DeleteBucketLifecycleOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the lifecycle configuration from the specified bucket. S3 removes all lifecycle configuration rules in the lifecycle subresource.

Permissions:

General purpose: Requires s3:PutLifecycleConfiguration permission
Directory buckets: Requires s3express:PutLifecycleConfiguration permission

Replication

GetBucketReplication { .api }

Returns the replication configuration of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketReplication(ctx context.Context, params *GetBucketReplicationInput, optFns ...func(*Options)) (*GetBucketReplicationOutput, error)

Input Type: GetBucketReplicationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	The bucket name for which to get the replication information
`ExpectedBucketOwner`	`*string`	No	The account ID of the expected bucket owner

Output Type: GetBucketReplicationOutput

Field	Type	Description
`ReplicationConfiguration`	`*types.ReplicationConfiguration`	Container for replication rules. Can add up to 1,000 rules. Maximum size is 2 MB
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

ReplicationConfiguration Type: types.ReplicationConfiguration

Field	Type	Required	Description
`Role`	`*string`	Yes	ARN of IAM role that S3 assumes when replicating objects
`Rules`	`[]types.ReplicationRule`	Yes	Container for information about a particular replication rule

ReplicationRule Type: types.ReplicationRule

Field	Type	Required	Description
`Destination`	`*types.Destination`	Yes	Container for information about the replication destination
`Status`	`types.ReplicationRuleStatus`	Yes	Status of the rule (Enabled, Disabled)
`DeleteMarkerReplication`	`*types.DeleteMarkerReplication`	No	Whether to replicate delete markers
`ExistingObjectReplication`	`*types.ExistingObjectReplication`	No	Replicate existing objects
`Filter`	`types.ReplicationRuleFilter`	No	Filter that identifies subset of objects
`ID`	`*string`	No	Unique identifier for rule (max 255 characters)
`Prefix`	`*string`	No	Object key name prefix (deprecated)
`Priority`	`*int32`	No	Priority for conflict resolution
`SourceSelectionCriteria`	`*types.SourceSelectionCriteria`	No	Container for filters that define replication source objects

Destination Type: types.Destination

Field	Type	Required	Description
`Bucket`	`*string`	Yes	ARN of S3 bucket where to store replicas
`AccessControlTranslation`	`*types.AccessControlTranslation`	No	Container for information about access control for replicas
`Account`	`*string`	No	Account ID for destination bucket owner
`EncryptionConfiguration`	`*types.EncryptionConfiguration`	No	Container for encryption information
`Metrics`	`*types.Metrics`	No	Container for replication metrics
`ReplicationTime`	`*types.ReplicationTime`	No	Container for S3 Replication Time Control (S3 RTC)
`StorageClass`	`types.StorageClass`	No	Storage class for replicas

Description: Returns the replication configuration of a bucket. It can take a while to propagate put or delete operations. Requires s3:GetReplicationConfiguration permission.

PutBucketReplication { .api }

Creates or updates a replication configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketReplication(ctx context.Context, params *PutBucketReplicationInput, optFns ...func(*Options)) (*PutBucketReplicationOutput, error)

Input Type: PutBucketReplicationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket
`ReplicationConfiguration`	`*types.ReplicationConfiguration`	Yes	Container for replication rules
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner
`Token`	`*string`	No	Token to allow Object Lock to be enabled

Output Type: PutBucketReplicationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Creates or updates a replication configuration. Versioning must be enabled on both source and destination buckets. Requires s3:PutReplicationConfiguration permission.

DeleteBucketReplication { .api }

Deletes the replication configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketReplication(ctx context.Context, params *DeleteBucketReplicationInput, optFns ...func(*Options)) (*DeleteBucketReplicationOutput, error)

Input Type: DeleteBucketReplicationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketReplicationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the replication configuration from the bucket. Requires s3:PutReplicationConfiguration permission.

Notifications

GetBucketNotificationConfiguration { .api }

Returns the notification configuration of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketNotificationConfiguration(ctx context.Context, params *GetBucketNotificationConfigurationInput, optFns ...func(*Options)) (*GetBucketNotificationConfigurationOutput, error)

Input Type: GetBucketNotificationConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket. Can use access point alias or Object Lambda access point alias
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketNotificationConfigurationOutput (also types.NotificationConfiguration)

Field	Type	Description
`EventBridgeConfiguration`	`*types.EventBridgeConfiguration`	Amazon EventBridge notifications
`LambdaFunctionConfigurations`	`[]types.LambdaFunctionConfiguration`	AWS Lambda function notifications
`QueueConfigurations`	`[]types.QueueConfiguration`	Amazon SQS queue notifications
`TopicConfigurations`	`[]types.TopicConfiguration`	Amazon SNS topic notifications
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

LambdaFunctionConfiguration Type: types.LambdaFunctionConfiguration

Field	Type	Required	Description
`Events`	`[]types.Event`	Yes	S3 bucket events for which to send notifications
`LambdaFunctionArn`	`*string`	Yes	ARN of AWS Lambda function to invoke
`Filter`	`*types.NotificationConfigurationFilter`	No	Container for object key name filtering rules
`Id`	`*string`	No	Optional unique identifier for configurations

QueueConfiguration Type: types.QueueConfiguration

Field	Type	Required	Description
`Events`	`[]types.Event`	Yes	S3 bucket events for which to send notifications
`QueueArn`	`*string`	Yes	ARN of Amazon SQS queue
`Filter`	`*types.NotificationConfigurationFilter`	No	Container for object key name filtering rules
`Id`	`*string`	No	Optional unique identifier for configurations

TopicConfiguration Type: types.TopicConfiguration

Field	Type	Required	Description
`Events`	`[]types.Event`	Yes	S3 bucket events for which to send notifications
`TopicArn`	`*string`	Yes	ARN of Amazon SNS topic
`Filter`	`*types.NotificationConfigurationFilter`	No	Container for object key name filtering rules
`Id`	`*string`	No	Optional unique identifier for configurations

EventBridgeConfiguration Type: types.EventBridgeConfiguration

(No fields - presence enables EventBridge)

NotificationConfigurationFilter Type: types.NotificationConfigurationFilter

Field	Type	Description
`Key`	`*types.S3KeyFilter`	Container for object key name prefix and suffix filtering rules

S3KeyFilter Type: types.S3KeyFilter

Field	Type	Description
`FilterRules`	`[]types.FilterRule`	List of filter rules

FilterRule Type: types.FilterRule

Field	Type	Description
`Name`	`types.FilterRuleName`	Object key name prefix or suffix identifying filter
`Value`	`*string`	Value to which filter matches

Description: Returns the notification configuration. If notifications are not enabled, returns an empty NotificationConfiguration element. Requires s3:GetBucketNotification permission.

PutBucketNotificationConfiguration { .api }

Enables or updates notifications for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketNotificationConfiguration(ctx context.Context, params *PutBucketNotificationConfigurationInput, optFns ...func(*Options)) (*PutBucketNotificationConfigurationOutput, error)

Input Type: PutBucketNotificationConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket
`NotificationConfiguration`	`*types.NotificationConfiguration`	Yes	Container for specifying the notification configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner
`SkipDestinationValidation`	`*bool`	No	Whether to skip validation of SNS, SQS, or Lambda ARNs

Output Type: PutBucketNotificationConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Enables notifications of specified events for a bucket. Requires s3:PutBucketNotification permission. You must also have permissions for SNS, SQS, or Lambda destinations.

Website Hosting

GetBucketWebsite { .api }

Returns the website configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketWebsite(ctx context.Context, params *GetBucketWebsiteInput, optFns ...func(*Options)) (*GetBucketWebsiteOutput, error)

Input Type: GetBucketWebsiteInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name for which to get the website configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketWebsiteOutput

Field	Type	Description
`ErrorDocument`	`*types.ErrorDocument`	Object key name of the website error document for 4XX class errors
`IndexDocument`	`*types.IndexDocument`	Name of the index document for the website
`RedirectAllRequestsTo`	`*types.RedirectAllRequestsTo`	Redirect behavior of all requests to website endpoint
`RoutingRules`	`[]types.RoutingRule`	Rules that define when a redirect is applied
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

IndexDocument Type: types.IndexDocument

Field	Type	Required	Description
`Suffix`	`*string`	Yes	Suffix appended to request for a directory (e.g., "index.html")

ErrorDocument Type: types.ErrorDocument

Field	Type	Required	Description
`Key`	`*string`	Yes	Object key name to use when 4XX class error occurs

RedirectAllRequestsTo Type: types.RedirectAllRequestsTo

Field	Type	Required	Description
`HostName`	`*string`	Yes	Name of host where requests are redirected
`Protocol`	`types.Protocol`	No	Protocol to use when redirecting (http, https)

RoutingRule Type: types.RoutingRule

Field	Type	Required	Description
`Redirect`	`*types.Redirect`	Yes	Container for redirect information
`Condition`	`*types.Condition`	No	Container for condition that must be met for rule to apply

Redirect Type: types.Redirect

Field	Type	Description
`HostName`	`*string`	Name of host where requests are redirected
`HttpRedirectCode`	`*string`	HTTP redirect code to use (e.g., "301")
`Protocol`	`types.Protocol`	Protocol to use (http, https)
`ReplaceKeyPrefixWith`	`*string`	Object key prefix to replace KeyPrefixEquals
`ReplaceKeyWith`	`*string`	Specific object key to use in redirect request

Condition Type: types.Condition

Field	Type	Description
`HttpErrorCodeReturnedEquals`	`*string`	HTTP error code when redirect applies
`KeyPrefixEquals`	`*string`	Object key name prefix when redirect applies

Description: Returns the website configuration for a bucket. Requires S3:GetBucketWebsite permission.

PutBucketWebsite { .api }

Sets the website configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketWebsite(ctx context.Context, params *PutBucketWebsiteInput, optFns ...func(*Options)) (*PutBucketWebsiteOutput, error)

Input Type: PutBucketWebsiteInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`WebsiteConfiguration`	`*types.WebsiteConfiguration`	Yes	Container for the request
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

WebsiteConfiguration Type: types.WebsiteConfiguration

Field	Type	Description
`ErrorDocument`	`*types.ErrorDocument`	Name of error document for the website
`IndexDocument`	`*types.IndexDocument`	Name of index document for the website
`RedirectAllRequestsTo`	`*types.RedirectAllRequestsTo`	Redirect behavior for every request to this bucket's website endpoint
`RoutingRules`	`[]types.RoutingRule`	Rules that define when redirect is applied

Output Type: PutBucketWebsiteOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the configuration of the website that is specified in the website subresource. Requires s3:PutBucketWebsite permission.

DeleteBucketWebsite { .api }

Removes the website configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketWebsite(ctx context.Context, params *DeleteBucketWebsiteInput, optFns ...func(*Options)) (*DeleteBucketWebsiteOutput, error)

Input Type: DeleteBucketWebsiteInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketWebsiteOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Removes the website configuration for a bucket. Bucket owner automatically has this permission. Requires s3:DeleteBucketWebsite permission.

Logging

GetBucketLogging { .api }

Returns the logging status of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketLogging(ctx context.Context, params *GetBucketLoggingInput, optFns ...func(*Options)) (*GetBucketLoggingOutput, error)

Input Type: GetBucketLoggingInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name for which to get the logging information
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketLoggingOutput

Field	Type	Description
`LoggingEnabled`	`*types.LoggingEnabled`	Describes where logs are stored and the prefix S3 assigns to log object keys
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

LoggingEnabled Type: types.LoggingEnabled

Field	Type	Required	Description
`TargetBucket`	`*string`	Yes	Bucket where you want S3 to store server access logs
`TargetPrefix`	`*string`	Yes	Prefix for all log object keys
`TargetGrants`	`[]types.TargetGrant`	No	Container for granting information. Not supported for bucket owner enforced setting
`TargetObjectKeyFormat`	`*types.TargetObjectKeyFormat`	No	S3 key format for log objects

TargetGrant Type: types.TargetGrant

Field	Type	Description
`Grantee`	`*types.Grantee`	Container for grantee information
`Permission`	`types.BucketLogsPermission`	Logging permissions assigned to grantee

TargetObjectKeyFormat Type: types.TargetObjectKeyFormat

Field	Type	Description
`PartitionedPrefix`	`*types.PartitionedPrefix`	Partitioned S3 key for log objects
`SimplePrefix`	`*types.SimplePrefix`	Use simple format for S3 keys for log objects (default)

Description: Returns the logging status of a bucket and the permissions users have to view and modify that status.

PutBucketLogging { .api }

Sets the logging parameters for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketLogging(ctx context.Context, params *PutBucketLoggingInput, optFns ...func(*Options)) (*PutBucketLoggingOutput, error)

Input Type: PutBucketLoggingInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`BucketLoggingStatus`	`*types.BucketLoggingStatus`	Yes	Container for logging status information
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

BucketLoggingStatus Type: types.BucketLoggingStatus

Field	Type	Description
`LoggingEnabled`	`*types.LoggingEnabled`	Container for logging information

Output Type: PutBucketLoggingOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the logging parameters for a bucket and specifies permissions for who can view and modify the logging parameters. Requires s3:PutBucketLogging permission.

Request Payment

GetBucketRequestPayment { .api }

Returns the request payment configuration of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketRequestPayment(ctx context.Context, params *GetBucketRequestPaymentInput, optFns ...func(*Options)) (*GetBucketRequestPaymentOutput, error)

Input Type: GetBucketRequestPaymentInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketRequestPaymentOutput

Field	Type	Description
`Payer`	`types.Payer`	Specifies who pays for download and request fees (Requester, BucketOwner)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Returns the request payment configuration of a bucket. Requires permission to perform the s3:GetBucketRequestPayment action.

PutBucketRequestPayment { .api }

Sets the request payment configuration for a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketRequestPayment(ctx context.Context, params *PutBucketRequestPaymentInput, optFns ...func(*Options)) (*PutBucketRequestPaymentOutput, error)

Input Type: PutBucketRequestPaymentInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Bucket name
`RequestPaymentConfiguration`	`*types.RequestPaymentConfiguration`	Yes	Container for Requester Pays information
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

RequestPaymentConfiguration Type: types.RequestPaymentConfiguration

Field	Type	Required	Description
`Payer`	`types.Payer`	Yes	Specifies who pays (Requester, BucketOwner)

Output Type: PutBucketRequestPaymentOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the request payment configuration for a bucket. By default, bucket owner pays for downloads from bucket. This configuration is for downloading data from Requester Pays buckets. Requires s3:PutBucketRequestPayment permission.

Transfer Acceleration

GetBucketAccelerateConfiguration { .api }

Returns the Transfer Acceleration state of a bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketAccelerateConfiguration(ctx context.Context, params *GetBucketAccelerateConfigurationInput, optFns ...func(*Options)) (*GetBucketAccelerateConfigurationOutput, error)

Input Type: GetBucketAccelerateConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket for which to get the accelerate configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner
`RequestPayer`	`types.RequestPayer`	No	Confirms requester knows they will be charged (requester)

Output Type: GetBucketAccelerateConfigurationOutput

Field	Type	Description
`Status`	`types.BucketAccelerateStatus`	Transfer acceleration state (Enabled, Suspended)
`RequestCharged`	`types.RequestCharged`	If present, indicates requester was successfully charged
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Returns the Transfer Acceleration state of a bucket, which is either Enabled or Suspended. Requires permission to perform s3:GetAccelerateConfiguration action.

PutBucketAccelerateConfiguration { .api }

Sets the accelerate configuration of an existing bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketAccelerateConfiguration(ctx context.Context, params *PutBucketAccelerateConfigurationInput, optFns ...func(*Options)) (*PutBucketAccelerateConfigurationOutput, error)

Input Type: PutBucketAccelerateConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket for which to set the accelerate configuration
`AccelerateConfiguration`	`*types.AccelerateConfiguration`	Yes	Container for setting the transfer acceleration state
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

AccelerateConfiguration Type: types.AccelerateConfiguration

Field	Type	Description
`Status`	`types.BucketAccelerateStatus`	Transfer acceleration status (Enabled, Suspended)

Output Type: PutBucketAccelerateConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets the accelerate configuration of an existing bucket. S3 Transfer Acceleration is a bucket-level feature that enables faster data transfers to/from S3. Requires s3:PutAccelerateConfiguration permission.

Analytics

GetBucketAnalyticsConfiguration { .api }

Gets an analytics configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketAnalyticsConfiguration(ctx context.Context, params *GetBucketAnalyticsConfigurationInput, optFns ...func(*Options)) (*GetBucketAnalyticsConfigurationOutput, error)

Input Type: GetBucketAnalyticsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket from which to get analytics configuration
`Id`	`*string`	Yes	ID used to identify the analytics configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketAnalyticsConfigurationOutput

Field	Type	Description
`AnalyticsConfiguration`	`*types.AnalyticsConfiguration`	Analytics configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

AnalyticsConfiguration Type: types.AnalyticsConfiguration

Field	Type	Required	Description
`Id`	`*string`	Yes	ID that identifies the analytics configuration
`StorageClassAnalysis`	`*types.StorageClassAnalysis`	Yes	Contains data related to access patterns
`Filter`	`types.AnalyticsFilter`	No	Filter to describe set of objects for analyses

StorageClassAnalysis Type: types.StorageClassAnalysis

Field	Type	Description
`DataExport`	`*types.StorageClassAnalysisDataExport`	Container for data related to the storage class analysis for an S3 bucket

StorageClassAnalysisDataExport Type: types.StorageClassAnalysisDataExport

Field	Type	Required	Description
`Destination`	`*types.AnalyticsExportDestination`	Yes	Place to store analysis results
`OutputSchemaVersion`	`types.StorageClassAnalysisSchemaVersion`	Yes	Version of output schema

AnalyticsExportDestination Type: types.AnalyticsExportDestination

Field	Type	Description
`S3BucketDestination`	`*types.AnalyticsS3BucketDestination`	Destination S3 bucket for storing analytics results

AnalyticsS3BucketDestination Type: types.AnalyticsS3BucketDestination

Field	Type	Required	Description
`Bucket`	`*string`	Yes	ARN of destination bucket
`Format`	`types.AnalyticsS3ExportFileFormat`	Yes	File format for export (CSV)
`BucketAccountId`	`*string`	No	Account ID that owns destination bucket
`Prefix`	`*string`	No	Prefix to append to exported analytics data

Description: Gets an analytics configuration from the bucket (identified by analytics configuration ID). Requires s3:GetAnalyticsConfiguration permission.

PutBucketAnalyticsConfiguration { .api }

Sets an analytics configuration for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketAnalyticsConfiguration(ctx context.Context, params *PutBucketAnalyticsConfigurationInput, optFns ...func(*Options)) (*PutBucketAnalyticsConfigurationOutput, error)

Input Type: PutBucketAnalyticsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket to which analytics configuration is stored
`Id`	`*string`	Yes	ID used to identify the analytics configuration
`AnalyticsConfiguration`	`*types.AnalyticsConfiguration`	Yes	Configuration and analytics filters to apply
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: PutBucketAnalyticsConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets an analytics configuration for the bucket (specified by analytics configuration ID). Can have up to 1,000 analytics configurations per bucket. Requires s3:PutAnalyticsConfiguration permission.

DeleteBucketAnalyticsConfiguration { .api }

Deletes an analytics configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketAnalyticsConfiguration(ctx context.Context, params *DeleteBucketAnalyticsConfigurationInput, optFns ...func(*Options)) (*DeleteBucketAnalyticsConfigurationOutput, error)

Input Type: DeleteBucketAnalyticsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket from which to delete analytics configuration
`Id`	`*string`	Yes	ID used to identify the analytics configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketAnalyticsConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes an analytics configuration from the bucket (identified by analytics configuration ID). Requires s3:PutAnalyticsConfiguration permission.

ListBucketAnalyticsConfigurations { .api }

Lists analytics configurations for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) ListBucketAnalyticsConfigurations(ctx context.Context, params *ListBucketAnalyticsConfigurationsInput, optFns ...func(*Options)) (*ListBucketAnalyticsConfigurationsOutput, error)

Input Type: ListBucketAnalyticsConfigurationsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket from which to list analytics configurations
`ContinuationToken`	`*string`	No	Token to continue the list (from previous response)
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: ListBucketAnalyticsConfigurationsOutput

Field	Type	Description
`AnalyticsConfigurationList`	`[]types.AnalyticsConfiguration`	List of analytics configurations
`ContinuationToken`	`*string`	Token used to continue this pagination request (provided for lists that are truncated)
`IsTruncated`	`*bool`	Indicates whether the returned list is complete
`NextContinuationToken`	`*string`	NextContinuationToken is sent when isTruncated is true, use this to continue pagination
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Lists the analytics configurations for the bucket. Can have up to 1,000 analytics configurations per bucket. Requires s3:GetAnalyticsConfiguration permission.

Metrics

GetBucketMetricsConfiguration { .api }

Gets a metrics configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketMetricsConfiguration(ctx context.Context, params *GetBucketMetricsConfigurationInput, optFns ...func(*Options)) (*GetBucketMetricsConfigurationOutput, error)

Input Type: GetBucketMetricsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing metrics configuration
`Id`	`*string`	Yes	ID used to identify the metrics configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketMetricsConfigurationOutput

Field	Type	Description
`MetricsConfiguration`	`*types.MetricsConfiguration`	Specifies the metrics configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

MetricsConfiguration Type: types.MetricsConfiguration

Field	Type	Required	Description
`Id`	`*string`	Yes	ID used to identify the metrics configuration
`Filter`	`types.MetricsFilter`	No	Specifies filter for metrics configuration

MetricsFilter Types:

The MetricsFilter is a union type that can be one of:

*types.MetricsFilterMemberAccessPointArn - Filter by access point ARN
*types.MetricsFilterMemberAnd - Logical AND of multiple predicates
*types.MetricsFilterMemberPrefix - Filter by prefix
*types.MetricsFilterMemberTag - Filter by tag

MetricsAndOperator Type: types.MetricsAndOperator

Field	Type	Description
`AccessPointArn`	`*string`	Access point ARN used when evaluating AND predicate
`Prefix`	`*string`	Prefix used when evaluating AND predicate
`Tags`	`[]types.Tag`	List of tags used when evaluating AND predicate

Description: Gets a metrics configuration (specified by metrics configuration ID) from the bucket. Requires s3:GetMetricsConfiguration permission.

PutBucketMetricsConfiguration { .api }

Sets a metrics configuration for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketMetricsConfiguration(ctx context.Context, params *PutBucketMetricsConfigurationInput, optFns ...func(*Options)) (*PutBucketMetricsConfigurationOutput, error)

Input Type: PutBucketMetricsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket for which metrics configuration is set
`Id`	`*string`	Yes	ID used to identify the metrics configuration
`MetricsConfiguration`	`*types.MetricsConfiguration`	Yes	Specifies the metrics configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: PutBucketMetricsConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Sets a metrics configuration (specified by metrics configuration ID) for the bucket. Can have up to 1,000 configurations per bucket. Requires s3:PutMetricsConfiguration permission.

DeleteBucketMetricsConfiguration { .api }

Deletes a metrics configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketMetricsConfiguration(ctx context.Context, params *DeleteBucketMetricsConfigurationInput, optFns ...func(*Options)) (*DeleteBucketMetricsConfigurationOutput, error)

Input Type: DeleteBucketMetricsConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing metrics configuration
`Id`	`*string`	Yes	ID used to identify the metrics configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketMetricsConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes a metrics configuration (specified by metrics configuration ID) from the bucket. Requires s3:PutMetricsConfiguration permission.

ListBucketMetricsConfigurations { .api }

Lists metrics configurations for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) ListBucketMetricsConfigurations(ctx context.Context, params *ListBucketMetricsConfigurationsInput, optFns ...func(*Options)) (*ListBucketMetricsConfigurationsOutput, error)

Input Type: ListBucketMetricsConfigurationsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing metrics configurations
`ContinuationToken`	`*string`	No	Token to continue the list (from previous response)
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: ListBucketMetricsConfigurationsOutput

Field	Type	Description
`ContinuationToken`	`*string`	Token used to continue this pagination request
`IsTruncated`	`*bool`	Indicates whether the returned list is complete
`MetricsConfigurationList`	`[]types.MetricsConfiguration`	Container for all metrics configurations
`NextContinuationToken`	`*string`	Token to retrieve next set of results (when IsTruncated is true)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Lists the metrics configurations for the bucket. Can have up to 1,000 configurations per bucket. Requires s3:GetMetricsConfiguration permission.

Inventory

GetBucketInventoryConfiguration { .api }

Returns an inventory configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketInventoryConfiguration(ctx context.Context, params *GetBucketInventoryConfigurationInput, optFns ...func(*Options)) (*GetBucketInventoryConfigurationOutput, error)

Input Type: GetBucketInventoryConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing inventory configuration
`Id`	`*string`	Yes	ID used to identify the inventory configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketInventoryConfigurationOutput

Field	Type	Description
`InventoryConfiguration`	`*types.InventoryConfiguration`	Specifies the inventory configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

InventoryConfiguration Type: types.InventoryConfiguration

Field	Type	Required	Description
`Destination`	`*types.InventoryDestination`	Yes	Contains information about where to publish inventory results
`Id`	`*string`	Yes	ID used to identify the inventory configuration
`IncludedObjectVersions`	`types.InventoryIncludedObjectVersions`	Yes	Object versions to include (All, Current)
`IsEnabled`	`*bool`	Yes	Specifies whether inventory is enabled or disabled
`Schedule`	`*types.InventorySchedule`	Yes	Specifies schedule for generating inventory results
`Filter`	`*types.InventoryFilter`	No	Specifies inventory filter
`OptionalFields`	`[]types.InventoryOptionalField`	No	Contains optional fields included in inventory results

InventoryDestination Type: types.InventoryDestination

Field	Type	Required	Description
`S3BucketDestination`	`*types.InventoryS3BucketDestination`	Yes	Contains bucket name, file format, bucket owner, and prefix where inventory results are published

InventoryS3BucketDestination Type: types.InventoryS3BucketDestination

Field	Type	Required	Description
`Bucket`	`*string`	Yes	ARN of bucket where inventory results will be published
`Format`	`types.InventoryFormat`	Yes	Output format of inventory results (CSV, ORC, Parquet)
`AccountId`	`*string`	No	Account ID that owns destination S3 bucket
`Encryption`	`*types.InventoryEncryption`	No	Contains type of server-side encryption used
`Prefix`	`*string`	No	Prefix prepended to all inventory results

InventorySchedule Type: types.InventorySchedule

Field	Type	Required	Description
`Frequency`	`types.InventoryFrequency`	Yes	How frequently inventory results are produced (Daily, Weekly)

InventoryFilter Type: types.InventoryFilter

Field	Type	Required	Description
`Prefix`	`*string`	Yes	Prefix that object must have to be included in inventory results

Description: Returns an inventory configuration (identified by inventory ID) from the bucket. Requires s3:GetInventoryConfiguration permission.

PutBucketInventoryConfiguration { .api }

Adds or replaces an inventory configuration for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketInventoryConfiguration(ctx context.Context, params *PutBucketInventoryConfigurationInput, optFns ...func(*Options)) (*PutBucketInventoryConfigurationOutput, error)

Input Type: PutBucketInventoryConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket where inventory configuration will be stored
`Id`	`*string`	Yes	ID used to identify the inventory configuration
`InventoryConfiguration`	`*types.InventoryConfiguration`	Yes	Specifies the inventory configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: PutBucketInventoryConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Adds an inventory configuration (identified by inventory ID) to the bucket. Can have up to 1,000 inventory configurations per bucket. Requires s3:PutInventoryConfiguration permission.

DeleteBucketInventoryConfiguration { .api }

Deletes an inventory configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketInventoryConfiguration(ctx context.Context, params *DeleteBucketInventoryConfigurationInput, optFns ...func(*Options)) (*DeleteBucketInventoryConfigurationOutput, error)

Input Type: DeleteBucketInventoryConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing inventory configuration
`Id`	`*string`	Yes	ID used to identify the inventory configuration
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketInventoryConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes an inventory configuration (identified by inventory ID) from the bucket. Requires s3:PutInventoryConfiguration permission.

ListBucketInventoryConfigurations { .api }

Returns a list of inventory configurations for the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) ListBucketInventoryConfigurations(ctx context.Context, params *ListBucketInventoryConfigurationsInput, optFns ...func(*Options)) (*ListBucketInventoryConfigurationsOutput, error)

Input Type: ListBucketInventoryConfigurationsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing inventory configurations
`ContinuationToken`	`*string`	No	Token to continue the list (from previous response)
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: ListBucketInventoryConfigurationsOutput

Field	Type	Description
`ContinuationToken`	`*string`	If sent in the request, indicates successful receipt
`InventoryConfigurationList`	`[]types.InventoryConfiguration`	List of inventory configurations for a bucket
`IsTruncated`	`*bool`	Indicates whether the list is complete or truncated
`NextContinuationToken`	`*string`	Token to retrieve next page (when IsTruncated is true)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Returns a list of inventory configurations for the bucket. Can have up to 1,000 configurations per bucket. Requires s3:GetInventoryConfiguration permission.

Intelligent-Tiering

GetBucketIntelligentTieringConfiguration { .api }

Gets the S3 Intelligent-Tiering configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) GetBucketIntelligentTieringConfiguration(ctx context.Context, params *GetBucketIntelligentTieringConfigurationInput, optFns ...func(*Options)) (*GetBucketIntelligentTieringConfigurationOutput, error)

Input Type: GetBucketIntelligentTieringConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing intelligent-tiering configuration
`Id`	`*string`	Yes	ID used to identify intelligent-tiering configuration

Output Type: GetBucketIntelligentTieringConfigurationOutput

Field	Type	Description
`IntelligentTieringConfiguration`	`*types.IntelligentTieringConfiguration`	Container for S3 Intelligent-Tiering configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

IntelligentTieringConfiguration Type: types.IntelligentTieringConfiguration

Field	Type	Required	Description
`Id`	`*string`	Yes	ID used to identify the S3 Intelligent-Tiering configuration
`Status`	`types.IntelligentTieringStatus`	Yes	Status of the configuration (Enabled, Disabled)
`Tierings`	`[]types.Tiering`	Yes	S3 Intelligent-Tiering storage class tier of the configuration
`Filter`	`*types.IntelligentTieringFilter`	No	Bucket filter (configuration only includes objects that meet filter's criteria)

Tiering Type: types.Tiering

Field	Type	Required	Description
`AccessTier`	`types.IntelligentTieringAccessTier`	Yes	S3 Intelligent-Tiering access tier (ARCHIVE_ACCESS, DEEP_ARCHIVE_ACCESS)
`Days`	`*int32`	Yes	Number of consecutive days of no access after which object will be eligible to transition

IntelligentTieringFilter Type: types.IntelligentTieringFilter

Field	Type	Description
`And`	`*types.IntelligentTieringAndOperator`	Logical AND of predicates
`Prefix`	`*string`	Object key name prefix
`Tag`	`*types.Tag`	Container of key-value name pair

IntelligentTieringAndOperator Type: types.IntelligentTieringAndOperator

Field	Type	Description
`Prefix`	`*string`	Object key name prefix identifying subset of objects
`Tags`	`[]types.Tag`	All tags that must exist in object tag set

Description: Gets the S3 Intelligent-Tiering configuration from the specified bucket. Requires s3:GetIntelligentTieringConfiguration permission.

PutBucketIntelligentTieringConfiguration { .api }

Puts a configuration for S3 Intelligent-Tiering. Not supported for directory buckets.

Method Signature:

func (c *Client) PutBucketIntelligentTieringConfiguration(ctx context.Context, params *PutBucketIntelligentTieringConfigurationInput, optFns ...func(*Options)) (*PutBucketIntelligentTieringConfigurationOutput, error)

Input Type: PutBucketIntelligentTieringConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket
`Id`	`*string`	Yes	ID used to identify S3 Intelligent-Tiering configuration
`IntelligentTieringConfiguration`	`*types.IntelligentTieringConfiguration`	Yes	Container for S3 Intelligent-Tiering configuration

Output Type: PutBucketIntelligentTieringConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Puts a configuration for S3 Intelligent-Tiering. This operation does not affect the lifecycle configuration for the bucket. Requires s3:PutIntelligentTieringConfiguration permission.

DeleteBucketIntelligentTieringConfiguration { .api }

Deletes the S3 Intelligent-Tiering configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) DeleteBucketIntelligentTieringConfiguration(ctx context.Context, params *DeleteBucketIntelligentTieringConfigurationInput, optFns ...func(*Options)) (*DeleteBucketIntelligentTieringConfigurationOutput, error)

Input Type: DeleteBucketIntelligentTieringConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing intelligent-tiering configuration
`Id`	`*string`	Yes	ID used to identify S3 Intelligent-Tiering configuration

Output Type: DeleteBucketIntelligentTieringConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the S3 Intelligent-Tiering configuration from the specified bucket. Requires s3:PutIntelligentTieringConfiguration permission.

ListBucketIntelligentTieringConfigurations { .api }

Lists the S3 Intelligent-Tiering configuration from the bucket. Not supported for directory buckets.

Method Signature:

func (c *Client) ListBucketIntelligentTieringConfigurations(ctx context.Context, params *ListBucketIntelligentTieringConfigurationsInput, optFns ...func(*Options)) (*ListBucketIntelligentTieringConfigurationsOutput, error)

Input Type: ListBucketIntelligentTieringConfigurationsInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the bucket containing intelligent-tiering configurations
`ContinuationToken`	`*string`	No	Token to continue the list (from previous response)

Output Type: ListBucketIntelligentTieringConfigurationsOutput

Field	Type	Description
`ContinuationToken`	`*string`	If sent in the request, indicates successful receipt
`IntelligentTieringConfigurationList`	`[]types.IntelligentTieringConfiguration`	List of S3 Intelligent-Tiering configurations for a bucket
`IsTruncated`	`*bool`	Indicates whether the list is complete or truncated
`NextContinuationToken`	`*string`	Token to retrieve next page (when IsTruncated is true)
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Lists the S3 Intelligent-Tiering configuration from the specified bucket. Requires s3:GetIntelligentTieringConfiguration permission.

Metadata Configuration

CreateBucketMetadataConfiguration { .api }

Creates a metadata configuration for a general purpose bucket.

Method Signature:

func (c *Client) CreateBucketMetadataConfiguration(ctx context.Context, params *CreateBucketMetadataConfigurationInput, optFns ...func(*Options)) (*CreateBucketMetadataConfigurationOutput, error)

Input Type: CreateBucketMetadataConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`MetadataConfiguration`	`*types.MetadataConfiguration`	Yes	S3 Metadata configuration for a general purpose bucket
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

MetadataConfiguration Type: types.MetadataConfiguration

Field	Type	Required	Description
`JournalTableConfiguration`	`*types.JournalTableConfiguration`	Yes	Journal table configuration for metadata configuration
`InventoryTableConfiguration`	`*types.InventoryTableConfiguration`	No	Inventory table configuration for metadata configuration

JournalTableConfiguration Type: types.JournalTableConfiguration

Field	Type	Required	Description
`S3TablesDestination`	`*types.S3TablesDestination`	Yes	S3 Tables destination for journal table
`ConfigurationState`	`types.JournalConfigurationState`	Yes	Configuration state (ENABLED, DISABLED)
`EncryptionConfiguration`	`*types.MetadataTableEncryptionConfiguration`	No	Encryption configuration for journal table
`JournalTableRetention`	`*types.JournalTableRetention`	No	Retention period for journal table records

InventoryTableConfiguration Type: types.InventoryTableConfiguration

Field	Type	Required	Description
`ConfigurationState`	`types.InventoryConfigurationState`	Yes	Configuration state (ENABLED, DISABLED)
`EncryptionConfiguration`	`*types.MetadataTableEncryptionConfiguration`	No	Encryption configuration for inventory table

S3TablesDestination Type: types.S3TablesDestination

Field	Type	Required	Description
`TableBucketArn`	`*string`	Yes	ARN of S3 Tables destination table bucket
`TableName`	`*string`	Yes	Name of metadata table
`TableNamespace`	`*string`	Yes	Namespace for metadata table

Output Type: CreateBucketMetadataConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Creates a metadata configuration for a general purpose bucket. The destination table bucket must be in the same Region and AWS account as the general purpose bucket.

GetBucketMetadataConfiguration { .api }

Retrieves the metadata configuration of a general purpose bucket.

Method Signature:

func (c *Client) GetBucketMetadataConfiguration(ctx context.Context, params *GetBucketMetadataConfigurationInput, optFns ...func(*Options)) (*GetBucketMetadataConfigurationOutput, error)

Input Type: GetBucketMetadataConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketMetadataConfigurationOutput

Field	Type	Description
`MetadataConfigurationResult`	`*types.MetadataConfigurationResult`	S3 Metadata configuration for a general purpose bucket
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

MetadataConfigurationResult Type: types.MetadataConfigurationResult

Field	Type	Required	Description
`DestinationResult`	`*types.DestinationResult`	Yes	Destination settings for metadata configuration
`InventoryTableConfigurationResult`	`*types.InventoryTableConfigurationResult`	No	Inventory table configuration for metadata configuration
`JournalTableConfigurationResult`	`*types.JournalTableConfigurationResult`	No	Journal table configuration for metadata configuration

Description: Retrieves the metadata configuration of a general purpose bucket.

DeleteBucketMetadataConfiguration { .api }

Deletes the metadata configuration of a general purpose bucket.

Method Signature:

func (c *Client) DeleteBucketMetadataConfiguration(ctx context.Context, params *DeleteBucketMetadataConfigurationInput, optFns ...func(*Options)) (*DeleteBucketMetadataConfigurationOutput, error)

Input Type: DeleteBucketMetadataConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketMetadataConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the metadata configuration of a general purpose bucket.

CreateBucketMetadataTableConfiguration { .api }

Creates a metadata table configuration for a general purpose bucket (V1 configuration).

Method Signature:

func (c *Client) CreateBucketMetadataTableConfiguration(ctx context.Context, params *CreateBucketMetadataTableConfigurationInput, optFns ...func(*Options)) (*CreateBucketMetadataTableConfigurationOutput, error)

Input Type: CreateBucketMetadataTableConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`MetadataTableConfiguration`	`*types.MetadataTableConfiguration`	Yes	V1 S3 Metadata configuration
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: CreateBucketMetadataTableConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Creates a V1 metadata table configuration. If created before July 15, 2025, it's recommended to delete and re-create using CreateBucketMetadataConfiguration.

GetBucketMetadataTableConfiguration { .api }

Retrieves the metadata table configuration of a general purpose bucket (V1).

Method Signature:

func (c *Client) GetBucketMetadataTableConfiguration(ctx context.Context, params *GetBucketMetadataTableConfigurationInput, optFns ...func(*Options)) (*GetBucketMetadataTableConfigurationOutput, error)

Input Type: GetBucketMetadataTableConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: GetBucketMetadataTableConfigurationOutput

Field	Type	Description
`GetBucketMetadataTableConfigurationResult`	`*types.MetadataTableConfigurationResult`	V1 S3 Metadata configuration
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Retrieves the V1 metadata table configuration of a general purpose bucket.

DeleteBucketMetadataTableConfiguration { .api }

Deletes the metadata table configuration of a general purpose bucket (V1).

Method Signature:

func (c *Client) DeleteBucketMetadataTableConfiguration(ctx context.Context, params *DeleteBucketMetadataTableConfigurationInput, optFns ...func(*Options)) (*DeleteBucketMetadataTableConfigurationOutput, error)

Input Type: DeleteBucketMetadataTableConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: DeleteBucketMetadataTableConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Deletes the V1 metadata table configuration of a general purpose bucket.

UpdateBucketMetadataInventoryTableConfiguration { .api }

Updates the inventory table configuration for bucket metadata.

Method Signature:

func (c *Client) UpdateBucketMetadataInventoryTableConfiguration(ctx context.Context, params *UpdateBucketMetadataInventoryTableConfigurationInput, optFns ...func(*Options)) (*UpdateBucketMetadataInventoryTableConfigurationOutput, error)

Input Type: UpdateBucketMetadataInventoryTableConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`InventoryTableConfiguration`	`*types.InventoryTableConfiguration`	Yes	Inventory table configuration
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: UpdateBucketMetadataInventoryTableConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Updates the inventory table configuration for an S3 Metadata configuration.

UpdateBucketMetadataJournalTableConfiguration { .api }

Updates the journal table configuration for bucket metadata.

Method Signature:

func (c *Client) UpdateBucketMetadataJournalTableConfiguration(ctx context.Context, params *UpdateBucketMetadataJournalTableConfigurationInput, optFns ...func(*Options)) (*UpdateBucketMetadataJournalTableConfigurationOutput, error)

Input Type: UpdateBucketMetadataJournalTableConfigurationInput

Field	Type	Required	Description
`Bucket`	`*string`	Yes	Name of the general purpose bucket
`JournalTableConfiguration`	`*types.JournalTableConfiguration`	Yes	Journal table configuration
`ChecksumAlgorithm`	`types.ChecksumAlgorithm`	No	Algorithm used to create checksum
`ContentMD5`	`*string`	No	Base64 encoded 128-bit MD5 digest
`ExpectedBucketOwner`	`*string`	No	Account ID of expected bucket owner

Output Type: UpdateBucketMetadataJournalTableConfigurationOutput

Field	Type	Description
`ResultMetadata`	`middleware.Metadata`	Metadata pertaining to the operation's result

Description: Updates the journal table configuration for an S3 Metadata configuration.

Common Types Reference

Enumerations

BucketVersioningStatus:

Enabled - Versioning is enabled
Suspended - Versioning is suspended

MFADeleteStatus:

Enabled - MFA delete is enabled
Disabled - MFA delete is disabled

ServerSideEncryption:

AES256 - Server-side encryption with S3-managed keys
aws:kms - Server-side encryption with KMS keys
aws:kms:dsse - Dual-layer server-side encryption with KMS keys

BucketAccelerateStatus:

Enabled - Transfer acceleration is enabled
Suspended - Transfer acceleration is suspended

ExpirationStatus:

Enabled - Rule is enabled
Disabled - Rule is disabled

IntelligentTieringStatus:

Enabled - Configuration is enabled
Disabled - Configuration is disabled

InventoryFrequency:

Daily - Inventory generated daily
Weekly - Inventory generated weekly

InventoryFormat:

CSV - Comma-separated values format
ORC - Apache ORC format
Parquet - Apache Parquet format

Payer:

Requester - Requester pays for requests and data transfer
BucketOwner - Bucket owner pays

Protocol:

http - HTTP protocol
https - HTTPS protocol

Notes

Directory Bucket Support: Many bucket configuration operations are not supported for directory buckets. Check individual operation descriptions for directory bucket compatibility.
Permissions: All operations require specific IAM permissions. Always verify you have the necessary permissions before calling these operations.
Propagation Time: Changes to bucket configurations may take time to propagate across all Amazon S3 systems.
Configuration Limits: Most configuration types have limits (e.g., 1,000 lifecycle rules, 1,000 analytics configurations per bucket).
Checksums: Many Put operations support optional checksum algorithms (CRC32, CRC32C, SHA1, SHA256) for data integrity validation.
ExpectedBucketOwner: This parameter helps prevent accidental operations on buckets you don't own. Not supported for directory buckets.

Version

Tile

Files

bucket-features.md.css-3qkkll{font-size:var(--chakra-font-sizes-sm);font-weight:var(--chakra-font-weights-normal);color:var(--chakra-colors-gray-300);}docs/

AWS SDK for Go v2 - S3 Bucket Features and Configuration Operations

Table of Contents

Versioning

GetBucketVersioning { .api }

PutBucketVersioning { .api }

Tagging

GetBucketTagging { .api }

PutBucketTagging { .api }

DeleteBucketTagging { .api }

CORS (Cross-Origin Resource Sharing)

GetBucketCors { .api }

PutBucketCors { .api }

DeleteBucketCors { .api }

Encryption

GetBucketEncryption { .api }

PutBucketEncryption { .api }

DeleteBucketEncryption { .api }

Lifecycle

GetBucketLifecycleConfiguration { .api }

PutBucketLifecycleConfiguration { .api }

DeleteBucketLifecycle { .api }

Replication

GetBucketReplication { .api }

PutBucketReplication { .api }

DeleteBucketReplication { .api }

Notifications

GetBucketNotificationConfiguration { .api }

PutBucketNotificationConfiguration { .api }

Website Hosting

GetBucketWebsite { .api }

PutBucketWebsite { .api }

DeleteBucketWebsite { .api }

Logging

GetBucketLogging { .api }

PutBucketLogging { .api }

Request Payment

GetBucketRequestPayment { .api }

PutBucketRequestPayment { .api }

Transfer Acceleration

GetBucketAccelerateConfiguration { .api }

PutBucketAccelerateConfiguration { .api }

Analytics

GetBucketAnalyticsConfiguration { .api }

PutBucketAnalyticsConfiguration { .api }

DeleteBucketAnalyticsConfiguration { .api }

ListBucketAnalyticsConfigurations { .api }

Metrics

GetBucketMetricsConfiguration { .api }

PutBucketMetricsConfiguration { .api }

DeleteBucketMetricsConfiguration { .api }

ListBucketMetricsConfigurations { .api }

Inventory

GetBucketInventoryConfiguration { .api }

PutBucketInventoryConfiguration { .api }

DeleteBucketInventoryConfiguration { .api }

ListBucketInventoryConfigurations { .api }

Intelligent-Tiering

GetBucketIntelligentTieringConfiguration { .api }

PutBucketIntelligentTieringConfiguration { .api }

DeleteBucketIntelligentTieringConfiguration { .api }

ListBucketIntelligentTieringConfigurations { .api }

Metadata Configuration

CreateBucketMetadataConfiguration { .api }

GetBucketMetadataConfiguration { .api }

DeleteBucketMetadataConfiguration { .api }

CreateBucketMetadataTableConfiguration { .api }

GetBucketMetadataTableConfiguration { .api }

DeleteBucketMetadataTableConfiguration { .api }

UpdateBucketMetadataInventoryTableConfiguration { .api }

UpdateBucketMetadataJournalTableConfiguration { .api }

Common Types Reference

Enumerations

Notes

Related Documentation

bucket-features.mddocs/