S3Client (AWS SDK for Java - 2.0.0-preview-1)

All Superinterfaces:

AutoCloseable
```
@Generated("software.amazon.awssdk:codegen")
public interface S3Client
extends AutoCloseable
```
Service client for accessing Amazon S3. This can be created using the static builder() method. null

Field Summary

Fields
Modifier and Type Field Description

static String SERVICE_NAME

Fields
Modifier and Type	Field	Description
`static String`	`SERVICE_NAME`

Method Summary

All Methods Static Methods Instance Methods Default Methods
Modifier and Type	Method	Description
`default AbortMultipartUploadResponse`	`abortMultipartUpload(AbortMultipartUploadRequest abortMultipartUploadRequest)`	Aborts a multipart upload.
`static S3ClientBuilder`	`builder()`	Create a builder that can be used to configure and create a `S3Client`.
`default CompleteMultipartUploadResponse`	`completeMultipartUpload(CompleteMultipartUploadRequest completeMultipartUploadRequest)`	Completes a multipart upload by assembling previously uploaded parts.
`default CopyObjectResponse`	`copyObject(CopyObjectRequest copyObjectRequest)`	Creates a copy of an object that is already stored in Amazon S3.
`static S3Client`	`create()`	Create a `S3Client` with the region loaded from the `DefaultAwsRegionProviderChain` and credentials loaded from the `DefaultCredentialsProvider`.
`default CreateBucketResponse`	`createBucket(CreateBucketRequest createBucketRequest)`	Creates a new bucket.
`default CreateMultipartUploadResponse`	`createMultipartUpload(CreateMultipartUploadRequest createMultipartUploadRequest)`	Initiates a multipart upload and returns an upload ID.
`default DeleteBucketResponse`	`deleteBucket(DeleteBucketRequest deleteBucketRequest)`	Deletes the bucket.
`default DeleteBucketAnalyticsConfigurationResponse`	`deleteBucketAnalyticsConfiguration(DeleteBucketAnalyticsConfigurationRequest deleteBucketAnalyticsConfigurationRequest)`	Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).
`default DeleteBucketCorsResponse`	`deleteBucketCors(DeleteBucketCorsRequest deleteBucketCorsRequest)`	Deletes the cors configuration information set for the bucket.
`default DeleteBucketInventoryConfigurationResponse`	`deleteBucketInventoryConfiguration(DeleteBucketInventoryConfigurationRequest deleteBucketInventoryConfigurationRequest)`	Deletes an inventory configuration (identified by the inventory ID) from the bucket.
`default DeleteBucketLifecycleResponse`	`deleteBucketLifecycle(DeleteBucketLifecycleRequest deleteBucketLifecycleRequest)`	Deletes the lifecycle configuration from the bucket.
`default DeleteBucketMetricsConfigurationResponse`	`deleteBucketMetricsConfiguration(DeleteBucketMetricsConfigurationRequest deleteBucketMetricsConfigurationRequest)`	Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.
`default DeleteBucketPolicyResponse`	`deleteBucketPolicy(DeleteBucketPolicyRequest deleteBucketPolicyRequest)`	Deletes the policy from the bucket.
`default DeleteBucketReplicationResponse`	`deleteBucketReplication(DeleteBucketReplicationRequest deleteBucketReplicationRequest)`	Deletes the replication configuration from the bucket.
`default DeleteBucketTaggingResponse`	`deleteBucketTagging(DeleteBucketTaggingRequest deleteBucketTaggingRequest)`	Deletes the tags from the bucket.
`default DeleteBucketWebsiteResponse`	`deleteBucketWebsite(DeleteBucketWebsiteRequest deleteBucketWebsiteRequest)`	This operation removes the website configuration from the bucket.
`default DeleteObjectResponse`	`deleteObject(DeleteObjectRequest deleteObjectRequest)`	Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object.
`default DeleteObjectsResponse`	`deleteObjects(DeleteObjectsRequest deleteObjectsRequest)`	This operation enables you to delete multiple objects from a bucket using a single HTTP request.
`default DeleteObjectTaggingResponse`	`deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest)`	Removes the tag-set from an existing object.
`default GetBucketAccelerateConfigurationResponse`	`getBucketAccelerateConfiguration(GetBucketAccelerateConfigurationRequest getBucketAccelerateConfigurationRequest)`	Returns the accelerate configuration of a bucket.
`default GetBucketAclResponse`	`getBucketAcl(GetBucketAclRequest getBucketAclRequest)`	Gets the access control policy for the bucket.
`default GetBucketAnalyticsConfigurationResponse`	`getBucketAnalyticsConfiguration(GetBucketAnalyticsConfigurationRequest getBucketAnalyticsConfigurationRequest)`	Gets an analytics configuration for the bucket (specified by the analytics configuration ID).
`default GetBucketCorsResponse`	`getBucketCors(GetBucketCorsRequest getBucketCorsRequest)`	Returns the cors configuration for the bucket.
`default GetBucketInventoryConfigurationResponse`	`getBucketInventoryConfiguration(GetBucketInventoryConfigurationRequest getBucketInventoryConfigurationRequest)`	Returns an inventory configuration (identified by the inventory ID) from the bucket.
`default GetBucketLifecycleResponse`	`getBucketLifecycle(GetBucketLifecycleRequest getBucketLifecycleRequest)`	Deprecated, see the GetBucketLifecycleConfiguration operation.
`default GetBucketLifecycleConfigurationResponse`	`getBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest getBucketLifecycleConfigurationRequest)`	Returns the lifecycle configuration information set on the bucket.
`default GetBucketLocationResponse`	`getBucketLocation(GetBucketLocationRequest getBucketLocationRequest)`	Returns the region the bucket resides in.
`default GetBucketLoggingResponse`	`getBucketLogging(GetBucketLoggingRequest getBucketLoggingRequest)`	Returns the logging status of a bucket and the permissions users have to view and modify that status.
`default GetBucketMetricsConfigurationResponse`	`getBucketMetricsConfiguration(GetBucketMetricsConfigurationRequest getBucketMetricsConfigurationRequest)`	Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.
`default GetBucketNotificationResponse`	`getBucketNotification(GetBucketNotificationRequest getBucketNotificationRequest)`	Deprecated, see the GetBucketNotificationConfiguration operation.
`default GetBucketNotificationConfigurationResponse`	`getBucketNotificationConfiguration(GetBucketNotificationConfigurationRequest getBucketNotificationConfigurationRequest)`	Returns the notification configuration of a bucket.
`default GetBucketPolicyResponse`	`getBucketPolicy(GetBucketPolicyRequest getBucketPolicyRequest)`	Returns the policy of a specified bucket.
`default GetBucketReplicationResponse`	`getBucketReplication(GetBucketReplicationRequest getBucketReplicationRequest)`	Returns the replication configuration of a bucket.
`default GetBucketRequestPaymentResponse`	`getBucketRequestPayment(GetBucketRequestPaymentRequest getBucketRequestPaymentRequest)`	Returns the request payment configuration of a bucket.
`default GetBucketTaggingResponse`	`getBucketTagging(GetBucketTaggingRequest getBucketTaggingRequest)`	Returns the tag set associated with the bucket.
`default GetBucketVersioningResponse`	`getBucketVersioning(GetBucketVersioningRequest getBucketVersioningRequest)`	Returns the versioning state of a bucket.
`default GetBucketWebsiteResponse`	`getBucketWebsite(GetBucketWebsiteRequest getBucketWebsiteRequest)`	Returns the website configuration for a bucket.
`default <ReturnT> ReturnT`	`getObject(GetObjectRequest getObjectRequest, StreamingResponseHandler streamingHandler)`	Retrieves objects from Amazon S3.
`default GetObjectAclResponse`	`getObjectAcl(GetObjectAclRequest getObjectAclRequest)`	Returns the access control list (ACL) of an object.
`default GetObjectTaggingResponse`	`getObjectTagging(GetObjectTaggingRequest getObjectTaggingRequest)`	Returns the tag-set of an object.
`default <ReturnT> ReturnT`	`getObjectTorrent(GetObjectTorrentRequest getObjectTorrentRequest, StreamingResponseHandler streamingHandler)`	Return torrent files from a bucket.
`default HeadBucketResponse`	`headBucket(HeadBucketRequest headBucketRequest)`	This operation is useful to determine if a bucket exists and you have permission to access it.
`default HeadObjectResponse`	`headObject(HeadObjectRequest headObjectRequest)`	The HEAD operation retrieves metadata from an object without returning the object itself.
`default ListBucketAnalyticsConfigurationsResponse`	`listBucketAnalyticsConfigurations(ListBucketAnalyticsConfigurationsRequest listBucketAnalyticsConfigurationsRequest)`	Lists the analytics configurations for the bucket.
`default ListBucketInventoryConfigurationsResponse`	`listBucketInventoryConfigurations(ListBucketInventoryConfigurationsRequest listBucketInventoryConfigurationsRequest)`	Returns a list of inventory configurations for the bucket.
`default ListBucketMetricsConfigurationsResponse`	`listBucketMetricsConfigurations(ListBucketMetricsConfigurationsRequest listBucketMetricsConfigurationsRequest)`	Lists the metrics configurations for the bucket.
`default ListBucketsResponse`	`listBuckets(ListBucketsRequest listBucketsRequest)`	Returns a list of all buckets owned by the authenticated sender of the request.
`default ListMultipartUploadsResponse`	`listMultipartUploads(ListMultipartUploadsRequest listMultipartUploadsRequest)`	This operation lists in-progress multipart uploads.
`default ListObjectsResponse`	`listObjects(ListObjectsRequest listObjectsRequest)`	Returns some or all (up to 1000) of the objects in a bucket.
`default ListObjectsV2Response`	`listObjectsV2(ListObjectsV2Request listObjectsV2Request)`	Returns some or all (up to 1000) of the objects in a bucket.
`default ListObjectVersionsResponse`	`listObjectVersions(ListObjectVersionsRequest listObjectVersionsRequest)`	Returns metadata about all of the versions of objects in a bucket.
`default ListPartsResponse`	`listParts(ListPartsRequest listPartsRequest)`	Lists the parts that have been uploaded for a specific multipart upload.
`default PutBucketAccelerateConfigurationResponse`	`putBucketAccelerateConfiguration(PutBucketAccelerateConfigurationRequest putBucketAccelerateConfigurationRequest)`	Sets the accelerate configuration of an existing bucket.
`default PutBucketAclResponse`	`putBucketAcl(PutBucketAclRequest putBucketAclRequest)`	Sets the permissions on a bucket using access control lists (ACL).
`default PutBucketAnalyticsConfigurationResponse`	`putBucketAnalyticsConfiguration(PutBucketAnalyticsConfigurationRequest putBucketAnalyticsConfigurationRequest)`	Sets an analytics configuration for the bucket (specified by the analytics configuration ID).
`default PutBucketCorsResponse`	`putBucketCors(PutBucketCorsRequest putBucketCorsRequest)`	Sets the cors configuration for a bucket.
`default PutBucketInventoryConfigurationResponse`	`putBucketInventoryConfiguration(PutBucketInventoryConfigurationRequest putBucketInventoryConfigurationRequest)`	Adds an inventory configuration (identified by the inventory ID) from the bucket.
`default PutBucketLifecycleResponse`	`putBucketLifecycle(PutBucketLifecycleRequest putBucketLifecycleRequest)`	Deprecated, see the PutBucketLifecycleConfiguration operation.
`default PutBucketLifecycleConfigurationResponse`	`putBucketLifecycleConfiguration(PutBucketLifecycleConfigurationRequest putBucketLifecycleConfigurationRequest)`	Sets lifecycle configuration for your bucket.
`default PutBucketLoggingResponse`	`putBucketLogging(PutBucketLoggingRequest putBucketLoggingRequest)`	Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters.
`default PutBucketMetricsConfigurationResponse`	`putBucketMetricsConfiguration(PutBucketMetricsConfigurationRequest putBucketMetricsConfigurationRequest)`	Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
`default PutBucketNotificationResponse`	`putBucketNotification(PutBucketNotificationRequest putBucketNotificationRequest)`	Deprecated, see the PutBucketNotificationConfiguraiton operation.
`default PutBucketNotificationConfigurationResponse`	`putBucketNotificationConfiguration(PutBucketNotificationConfigurationRequest putBucketNotificationConfigurationRequest)`	Enables notifications of specified events for a bucket.
`default PutBucketPolicyResponse`	`putBucketPolicy(PutBucketPolicyRequest putBucketPolicyRequest)`	Replaces a policy on a bucket.
`default PutBucketReplicationResponse`	`putBucketReplication(PutBucketReplicationRequest putBucketReplicationRequest)`	Creates a new replication configuration (or replaces an existing one, if present).
`default PutBucketRequestPaymentResponse`	`putBucketRequestPayment(PutBucketRequestPaymentRequest putBucketRequestPaymentRequest)`	Sets the request payment configuration for a bucket.
`default PutBucketTaggingResponse`	`putBucketTagging(PutBucketTaggingRequest putBucketTaggingRequest)`	Sets the tags for a bucket.
`default PutBucketVersioningResponse`	`putBucketVersioning(PutBucketVersioningRequest putBucketVersioningRequest)`	Sets the versioning state of an existing bucket.
`default PutBucketWebsiteResponse`	`putBucketWebsite(PutBucketWebsiteRequest putBucketWebsiteRequest)`	Set the website configuration for a bucket.
`default PutObjectResponse`	`putObject(PutObjectRequest putObjectRequest, RequestBody requestBody)`	Adds an object to a bucket.
`default PutObjectAclResponse`	`putObjectAcl(PutObjectAclRequest putObjectAclRequest)`	uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket
`default PutObjectTaggingResponse`	`putObjectTagging(PutObjectTaggingRequest putObjectTaggingRequest)`	Sets the supplied tag-set to an object that already exists in a bucket
`default RestoreObjectResponse`	`restoreObject(RestoreObjectRequest restoreObjectRequest)`	Restores an archived copy of an object back into Amazon S3
`static ServiceMetadata`	`serviceMetadata()`
`default UploadPartResponse`	`uploadPart(UploadPartRequest uploadPartRequest, RequestBody requestBody)`	Uploads a part in a multipart upload.
`default UploadPartCopyResponse`	`uploadPartCopy(UploadPartCopyRequest uploadPartCopyRequest)`	Uploads a part by copying data from an existing object as data source.

Methods inherited from interface java.lang.AutoCloseable
close

Field Detail
- SERVICE_NAME
```
static final String SERVICE_NAME
```
  See Also:
  
  Constant Field Values

Method Detail

create
```
static S3Client create()
```
Create a S3Client with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder
```
static S3ClientBuilder builder()
```
Create a builder that can be used to configure and create a S3Client.

abortMultipartUpload
```
default AbortMultipartUploadResponse abortMultipartUpload(AbortMultipartUploadRequest abortMultipartUploadRequest)
                                                   throws NoSuchUploadException,
                                                          SdkBaseException,
                                                          SdkClientException,
                                                          S3Exception
```
Aborts a multipart upload.

To verify that all parts have been removed, so you don't get charged for the part storage, you should call the List Parts operation and ensure the parts list is empty.

Parameters:

abortMultipartUploadRequest -

Returns:

Result of the AbortMultipartUpload operation returned by the service.

Throws:

NoSuchUploadException - The specified multipart upload does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

completeMultipartUpload

default CompleteMultipartUploadResponse completeMultipartUpload(CompleteMultipartUploadRequest completeMultipartUploadRequest)
                                                         throws SdkBaseException,
                                                                SdkClientException,
                                                                S3Exception

Completes a multipart upload by assembling previously uploaded parts.

Parameters:: completeMultipartUploadRequest -
Returns:: Result of the CompleteMultipartUpload operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

copyObject
```
default CopyObjectResponse copyObject(CopyObjectRequest copyObjectRequest)
                               throws ObjectNotInActiveTierErrorException,
                                      SdkBaseException,
                                      SdkClientException,
                                      S3Exception
```
Creates a copy of an object that is already stored in Amazon S3.

Parameters:

copyObjectRequest -

Returns:

Result of the CopyObject operation returned by the service.

Throws:

ObjectNotInActiveTierErrorException - The source object of the COPY operation is not in the active tier and is only stored in Amazon Glacier.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

createBucket
```
default CreateBucketResponse createBucket(CreateBucketRequest createBucketRequest)
                                   throws BucketAlreadyExistsException,
                                          BucketAlreadyOwnedByYouException,
                                          SdkBaseException,
                                          SdkClientException,
                                          S3Exception
```
Creates a new bucket.

Parameters:

createBucketRequest -

Returns:

Result of the CreateBucket operation returned by the service.

Throws:

BucketAlreadyExistsException - The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.

BucketAlreadyOwnedByYouException

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

createMultipartUpload
```
default CreateMultipartUploadResponse createMultipartUpload(CreateMultipartUploadRequest createMultipartUploadRequest)
                                                     throws SdkBaseException,
                                                            SdkClientException,
                                                            S3Exception
```
Initiates a multipart upload and returns an upload ID.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.

Parameters:

createMultipartUploadRequest -

Returns:

Result of the CreateMultipartUpload operation returned by the service.

Throws:

SdkBaseException

SdkClientException

S3Exception

deleteBucket

default DeleteBucketResponse deleteBucket(DeleteBucketRequest deleteBucketRequest)
                                   throws SdkBaseException,
                                          SdkClientException,
                                          S3Exception

Deletes the bucket. All objects (including all object versions and Delete Markers) in the bucket must be deleted before the bucket itself can be deleted.

Parameters:: deleteBucketRequest -
Returns:: Result of the DeleteBucket operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketAnalyticsConfiguration

default DeleteBucketAnalyticsConfigurationResponse deleteBucketAnalyticsConfiguration(DeleteBucketAnalyticsConfigurationRequest deleteBucketAnalyticsConfigurationRequest)
                                                                               throws SdkBaseException,
                                                                                      SdkClientException,
                                                                                      S3Exception

Deletes an analytics configuration for the bucket (specified by the analytics configuration ID).

Parameters:: deleteBucketAnalyticsConfigurationRequest -
Returns:: Result of the DeleteBucketAnalyticsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketCors

default DeleteBucketCorsResponse deleteBucketCors(DeleteBucketCorsRequest deleteBucketCorsRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Deletes the cors configuration information set for the bucket.

Parameters:: deleteBucketCorsRequest -
Returns:: Result of the DeleteBucketCors operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketInventoryConfiguration

default DeleteBucketInventoryConfigurationResponse deleteBucketInventoryConfiguration(DeleteBucketInventoryConfigurationRequest deleteBucketInventoryConfigurationRequest)
                                                                               throws SdkBaseException,
                                                                                      SdkClientException,
                                                                                      S3Exception

Deletes an inventory configuration (identified by the inventory ID) from the bucket.

Parameters:: deleteBucketInventoryConfigurationRequest -
Returns:: Result of the DeleteBucketInventoryConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketLifecycle

default DeleteBucketLifecycleResponse deleteBucketLifecycle(DeleteBucketLifecycleRequest deleteBucketLifecycleRequest)
                                                     throws SdkBaseException,
                                                            SdkClientException,
                                                            S3Exception

Deletes the lifecycle configuration from the bucket.

Parameters:: deleteBucketLifecycleRequest -
Returns:: Result of the DeleteBucketLifecycle operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketMetricsConfiguration

default DeleteBucketMetricsConfigurationResponse deleteBucketMetricsConfiguration(DeleteBucketMetricsConfigurationRequest deleteBucketMetricsConfigurationRequest)
                                                                           throws SdkBaseException,
                                                                                  SdkClientException,
                                                                                  S3Exception

Deletes a metrics configuration (specified by the metrics configuration ID) from the bucket.

Parameters:: deleteBucketMetricsConfigurationRequest -
Returns:: Result of the DeleteBucketMetricsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketPolicy

default DeleteBucketPolicyResponse deleteBucketPolicy(DeleteBucketPolicyRequest deleteBucketPolicyRequest)
                                               throws SdkBaseException,
                                                      SdkClientException,
                                                      S3Exception

Deletes the policy from the bucket.

Parameters:: deleteBucketPolicyRequest -
Returns:: Result of the DeleteBucketPolicy operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketReplication

default DeleteBucketReplicationResponse deleteBucketReplication(DeleteBucketReplicationRequest deleteBucketReplicationRequest)
                                                         throws SdkBaseException,
                                                                SdkClientException,
                                                                S3Exception

Deletes the replication configuration from the bucket.

Parameters:: deleteBucketReplicationRequest -
Returns:: Result of the DeleteBucketReplication operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketTagging

default DeleteBucketTaggingResponse deleteBucketTagging(DeleteBucketTaggingRequest deleteBucketTaggingRequest)
                                                 throws SdkBaseException,
                                                        SdkClientException,
                                                        S3Exception

Deletes the tags from the bucket.

Parameters:: deleteBucketTaggingRequest -
Returns:: Result of the DeleteBucketTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteBucketWebsite

default DeleteBucketWebsiteResponse deleteBucketWebsite(DeleteBucketWebsiteRequest deleteBucketWebsiteRequest)
                                                 throws SdkBaseException,
                                                        SdkClientException,
                                                        S3Exception

This operation removes the website configuration from the bucket.

Parameters:: deleteBucketWebsiteRequest -
Returns:: Result of the DeleteBucketWebsite operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteObject
```
default DeleteObjectResponse deleteObject(DeleteObjectRequest deleteObjectRequest)
                                   throws SdkBaseException,
                                          SdkClientException,
                                          S3Exception
```
Removes the null version (if there is one) of an object and inserts a delete marker, which becomes the latest version of the object. If there isn't a null version, Amazon S3 does not remove any objects.

Parameters:

deleteObjectRequest -

Returns:

Result of the DeleteObject operation returned by the service.

Throws:

SdkBaseException

SdkClientException

S3Exception

deleteObjectTagging

default DeleteObjectTaggingResponse deleteObjectTagging(DeleteObjectTaggingRequest deleteObjectTaggingRequest)
                                                 throws SdkBaseException,
                                                        SdkClientException,
                                                        S3Exception

Removes the tag-set from an existing object.

Parameters:: deleteObjectTaggingRequest -
Returns:: Result of the DeleteObjectTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

deleteObjects

default DeleteObjectsResponse deleteObjects(DeleteObjectsRequest deleteObjectsRequest)
                                     throws SdkBaseException,
                                            SdkClientException,
                                            S3Exception

This operation enables you to delete multiple objects from a bucket using a single HTTP request. You may specify up to 1000 keys.

Parameters:: deleteObjectsRequest -
Returns:: Result of the DeleteObjects operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketAccelerateConfiguration

default GetBucketAccelerateConfigurationResponse getBucketAccelerateConfiguration(GetBucketAccelerateConfigurationRequest getBucketAccelerateConfigurationRequest)
                                                                           throws SdkBaseException,
                                                                                  SdkClientException,
                                                                                  S3Exception

Returns the accelerate configuration of a bucket.

Parameters:: getBucketAccelerateConfigurationRequest -
Returns:: Result of the GetBucketAccelerateConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketAcl

default GetBucketAclResponse getBucketAcl(GetBucketAclRequest getBucketAclRequest)
                                   throws SdkBaseException,
                                          SdkClientException,
                                          S3Exception

Gets the access control policy for the bucket.

Parameters:: getBucketAclRequest -
Returns:: Result of the GetBucketAcl operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketAnalyticsConfiguration

default GetBucketAnalyticsConfigurationResponse getBucketAnalyticsConfiguration(GetBucketAnalyticsConfigurationRequest getBucketAnalyticsConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Gets an analytics configuration for the bucket (specified by the analytics configuration ID).

Parameters:: getBucketAnalyticsConfigurationRequest -
Returns:: Result of the GetBucketAnalyticsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketCors

default GetBucketCorsResponse getBucketCors(GetBucketCorsRequest getBucketCorsRequest)
                                     throws SdkBaseException,
                                            SdkClientException,
                                            S3Exception

Returns the cors configuration for the bucket.

Parameters:: getBucketCorsRequest -
Returns:: Result of the GetBucketCors operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketInventoryConfiguration

default GetBucketInventoryConfigurationResponse getBucketInventoryConfiguration(GetBucketInventoryConfigurationRequest getBucketInventoryConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Returns an inventory configuration (identified by the inventory ID) from the bucket.

Parameters:: getBucketInventoryConfigurationRequest -
Returns:: Result of the GetBucketInventoryConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketLifecycle

default GetBucketLifecycleResponse getBucketLifecycle(GetBucketLifecycleRequest getBucketLifecycleRequest)
                                               throws SdkBaseException,
                                                      SdkClientException,
                                                      S3Exception

Deprecated, see the GetBucketLifecycleConfiguration operation.

Parameters:: getBucketLifecycleRequest -
Returns:: Result of the GetBucketLifecycle operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketLifecycleConfiguration

default GetBucketLifecycleConfigurationResponse getBucketLifecycleConfiguration(GetBucketLifecycleConfigurationRequest getBucketLifecycleConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Returns the lifecycle configuration information set on the bucket.

Parameters:: getBucketLifecycleConfigurationRequest -
Returns:: Result of the GetBucketLifecycleConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketLocation

default GetBucketLocationResponse getBucketLocation(GetBucketLocationRequest getBucketLocationRequest)
                                             throws SdkBaseException,
                                                    SdkClientException,
                                                    S3Exception

Returns the region the bucket resides in.

Parameters:: getBucketLocationRequest -
Returns:: Result of the GetBucketLocation operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketLogging

default GetBucketLoggingResponse getBucketLogging(GetBucketLoggingRequest getBucketLoggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

Parameters:: getBucketLoggingRequest -
Returns:: Result of the GetBucketLogging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketMetricsConfiguration

default GetBucketMetricsConfigurationResponse getBucketMetricsConfiguration(GetBucketMetricsConfigurationRequest getBucketMetricsConfigurationRequest)
                                                                     throws SdkBaseException,
                                                                            SdkClientException,
                                                                            S3Exception

Gets a metrics configuration (specified by the metrics configuration ID) from the bucket.

Parameters:: getBucketMetricsConfigurationRequest -
Returns:: Result of the GetBucketMetricsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketNotification

default GetBucketNotificationResponse getBucketNotification(GetBucketNotificationRequest getBucketNotificationRequest)
                                                     throws SdkBaseException,
                                                            SdkClientException,
                                                            S3Exception

Deprecated, see the GetBucketNotificationConfiguration operation.

Parameters:: getBucketNotificationRequest -
Returns:: Result of the GetBucketNotification operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketNotificationConfiguration

default GetBucketNotificationConfigurationResponse getBucketNotificationConfiguration(GetBucketNotificationConfigurationRequest getBucketNotificationConfigurationRequest)
                                                                               throws SdkBaseException,
                                                                                      SdkClientException,
                                                                                      S3Exception

Returns the notification configuration of a bucket.

Parameters:: getBucketNotificationConfigurationRequest -
Returns:: Result of the GetBucketNotificationConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketPolicy

default GetBucketPolicyResponse getBucketPolicy(GetBucketPolicyRequest getBucketPolicyRequest)
                                         throws SdkBaseException,
                                                SdkClientException,
                                                S3Exception

Returns the policy of a specified bucket.

Parameters:: getBucketPolicyRequest -
Returns:: Result of the GetBucketPolicy operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketReplication

default GetBucketReplicationResponse getBucketReplication(GetBucketReplicationRequest getBucketReplicationRequest)
                                                   throws SdkBaseException,
                                                          SdkClientException,
                                                          S3Exception

Returns the replication configuration of a bucket.

Parameters:: getBucketReplicationRequest -
Returns:: Result of the GetBucketReplication operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketRequestPayment

default GetBucketRequestPaymentResponse getBucketRequestPayment(GetBucketRequestPaymentRequest getBucketRequestPaymentRequest)
                                                         throws SdkBaseException,
                                                                SdkClientException,
                                                                S3Exception

Returns the request payment configuration of a bucket.

Parameters:: getBucketRequestPaymentRequest -
Returns:: Result of the GetBucketRequestPayment operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketTagging

default GetBucketTaggingResponse getBucketTagging(GetBucketTaggingRequest getBucketTaggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Returns the tag set associated with the bucket.

Parameters:: getBucketTaggingRequest -
Returns:: Result of the GetBucketTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketVersioning

default GetBucketVersioningResponse getBucketVersioning(GetBucketVersioningRequest getBucketVersioningRequest)
                                                 throws SdkBaseException,
                                                        SdkClientException,
                                                        S3Exception

Returns the versioning state of a bucket.

Parameters:: getBucketVersioningRequest -
Returns:: Result of the GetBucketVersioning operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getBucketWebsite

default GetBucketWebsiteResponse getBucketWebsite(GetBucketWebsiteRequest getBucketWebsiteRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Returns the website configuration for a bucket.

Parameters:: getBucketWebsiteRequest -
Returns:: Result of the GetBucketWebsite operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getObject
```
default <ReturnT> ReturnT getObject(GetObjectRequest getObjectRequest,
                                    StreamingResponseHandler streamingHandler)
                             throws NoSuchKeyException,
                                    SdkBaseException,
                                    SdkClientException,
                                    S3Exception
```
Retrieves objects from Amazon S3.

Parameters:

getObjectRequest -

streamingHandler - Functional interface for processing the streamed response content. The unmarshalled GetObjectResponse and an InputStream to the response content are provided as parameters to the callback. The callback may return a transformed type which will be the return value of this method. See software.amazon.awssdk.runtime.transform.StreamingResponseHandler for details on implementing this interface and for links to precanned implementations for common scenarios like downloading to a file. The service documentation for the response content is as follows 'Object data.'.

Returns:

The transformed result of the StreamingResponseHandler.

Throws:

NoSuchKeyException - The specified key does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

getObjectAcl
```
default GetObjectAclResponse getObjectAcl(GetObjectAclRequest getObjectAclRequest)
                                   throws NoSuchKeyException,
                                          SdkBaseException,
                                          SdkClientException,
                                          S3Exception
```
Returns the access control list (ACL) of an object.

Parameters:

getObjectAclRequest -

Returns:

Result of the GetObjectAcl operation returned by the service.

Throws:

NoSuchKeyException - The specified key does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

getObjectTagging

default GetObjectTaggingResponse getObjectTagging(GetObjectTaggingRequest getObjectTaggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Returns the tag-set of an object.

Parameters:: getObjectTaggingRequest -
Returns:: Result of the GetObjectTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

getObjectTorrent
```
default <ReturnT> ReturnT getObjectTorrent(GetObjectTorrentRequest getObjectTorrentRequest,
                                           StreamingResponseHandler streamingHandler)
                                    throws SdkBaseException,
                                           SdkClientException,
                                           S3Exception
```
Return torrent files from a bucket.

Parameters:

getObjectTorrentRequest -

streamingHandler - Functional interface for processing the streamed response content. The unmarshalled GetObjectTorrentResponse and an InputStream to the response content are provided as parameters to the callback. The callback may return a transformed type which will be the return value of this method. See software.amazon.awssdk.runtime.transform.StreamingResponseHandler for details on implementing this interface and for links to precanned implementations for common scenarios like downloading to a file. The service documentation for the response content is as follows ''.

Returns:

The transformed result of the StreamingResponseHandler.

Throws:

SdkBaseException

SdkClientException

S3Exception

headBucket
```
default HeadBucketResponse headBucket(HeadBucketRequest headBucketRequest)
                               throws NoSuchBucketException,
                                      SdkBaseException,
                                      SdkClientException,
                                      S3Exception
```
This operation is useful to determine if a bucket exists and you have permission to access it.

Parameters:

headBucketRequest -

Returns:

Result of the HeadBucket operation returned by the service.

Throws:

NoSuchBucketException - The specified bucket does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

headObject
```
default HeadObjectResponse headObject(HeadObjectRequest headObjectRequest)
                               throws NoSuchKeyException,
                                      SdkBaseException,
                                      SdkClientException,
                                      S3Exception
```
The HEAD operation retrieves metadata from an object without returning the object itself. This operation is useful if you're only interested in an object's metadata. To use HEAD, you must have READ access to the object.

Parameters:

headObjectRequest -

Returns:

Result of the HeadObject operation returned by the service.

Throws:

NoSuchKeyException - The specified key does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

listBucketAnalyticsConfigurations

default ListBucketAnalyticsConfigurationsResponse listBucketAnalyticsConfigurations(ListBucketAnalyticsConfigurationsRequest listBucketAnalyticsConfigurationsRequest)
                                                                             throws SdkBaseException,
                                                                                    SdkClientException,
                                                                                    S3Exception

Lists the analytics configurations for the bucket.

Parameters:: listBucketAnalyticsConfigurationsRequest -
Returns:: Result of the ListBucketAnalyticsConfigurations operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listBucketInventoryConfigurations

default ListBucketInventoryConfigurationsResponse listBucketInventoryConfigurations(ListBucketInventoryConfigurationsRequest listBucketInventoryConfigurationsRequest)
                                                                             throws SdkBaseException,
                                                                                    SdkClientException,
                                                                                    S3Exception

Returns a list of inventory configurations for the bucket.

Parameters:: listBucketInventoryConfigurationsRequest -
Returns:: Result of the ListBucketInventoryConfigurations operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listBucketMetricsConfigurations

default ListBucketMetricsConfigurationsResponse listBucketMetricsConfigurations(ListBucketMetricsConfigurationsRequest listBucketMetricsConfigurationsRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Lists the metrics configurations for the bucket.

Parameters:: listBucketMetricsConfigurationsRequest -
Returns:: Result of the ListBucketMetricsConfigurations operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listBuckets

default ListBucketsResponse listBuckets(ListBucketsRequest listBucketsRequest)
                                 throws SdkBaseException,
                                        SdkClientException,
                                        S3Exception

Returns a list of all buckets owned by the authenticated sender of the request.

Parameters:: listBucketsRequest -
Returns:: Result of the ListBuckets operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listMultipartUploads

default ListMultipartUploadsResponse listMultipartUploads(ListMultipartUploadsRequest listMultipartUploadsRequest)
                                                   throws SdkBaseException,
                                                          SdkClientException,
                                                          S3Exception

This operation lists in-progress multipart uploads.

Parameters:: listMultipartUploadsRequest -
Returns:: Result of the ListMultipartUploads operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listObjectVersions

default ListObjectVersionsResponse listObjectVersions(ListObjectVersionsRequest listObjectVersionsRequest)
                                               throws SdkBaseException,
                                                      SdkClientException,
                                                      S3Exception

Returns metadata about all of the versions of objects in a bucket.

Parameters:: listObjectVersionsRequest -
Returns:: Result of the ListObjectVersions operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

listObjects
```
default ListObjectsResponse listObjects(ListObjectsRequest listObjectsRequest)
                                 throws NoSuchBucketException,
                                        SdkBaseException,
                                        SdkClientException,
                                        S3Exception
```
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket.

Parameters:

listObjectsRequest -

Returns:

Result of the ListObjects operation returned by the service.

Throws:

NoSuchBucketException - The specified bucket does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

listObjectsV2
```
default ListObjectsV2Response listObjectsV2(ListObjectsV2Request listObjectsV2Request)
                                     throws NoSuchBucketException,
                                            SdkBaseException,
                                            SdkClientException,
                                            S3Exception
```
Returns some or all (up to 1000) of the objects in a bucket. You can use the request parameters as selection criteria to return a subset of the objects in a bucket. Note: ListObjectsV2 is the revised List Objects API and we recommend you use this revised API for new application development.

Parameters:

listObjectsV2Request -

Returns:

Result of the ListObjectsV2 operation returned by the service.

Throws:

NoSuchBucketException - The specified bucket does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

listParts

default ListPartsResponse listParts(ListPartsRequest listPartsRequest)
                             throws SdkBaseException,
                                    SdkClientException,
                                    S3Exception

Lists the parts that have been uploaded for a specific multipart upload.

Parameters:: listPartsRequest -
Returns:: Result of the ListParts operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketAccelerateConfiguration

default PutBucketAccelerateConfigurationResponse putBucketAccelerateConfiguration(PutBucketAccelerateConfigurationRequest putBucketAccelerateConfigurationRequest)
                                                                           throws SdkBaseException,
                                                                                  SdkClientException,
                                                                                  S3Exception

Sets the accelerate configuration of an existing bucket.

Parameters:: putBucketAccelerateConfigurationRequest -
Returns:: Result of the PutBucketAccelerateConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketAcl

default PutBucketAclResponse putBucketAcl(PutBucketAclRequest putBucketAclRequest)
                                   throws SdkBaseException,
                                          SdkClientException,
                                          S3Exception

Sets the permissions on a bucket using access control lists (ACL).

Parameters:: putBucketAclRequest -
Returns:: Result of the PutBucketAcl operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketAnalyticsConfiguration

default PutBucketAnalyticsConfigurationResponse putBucketAnalyticsConfiguration(PutBucketAnalyticsConfigurationRequest putBucketAnalyticsConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Sets an analytics configuration for the bucket (specified by the analytics configuration ID).

Parameters:: putBucketAnalyticsConfigurationRequest -
Returns:: Result of the PutBucketAnalyticsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketCors

default PutBucketCorsResponse putBucketCors(PutBucketCorsRequest putBucketCorsRequest)
                                     throws SdkBaseException,
                                            SdkClientException,
                                            S3Exception

Sets the cors configuration for a bucket.

Parameters:: putBucketCorsRequest -
Returns:: Result of the PutBucketCors operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketInventoryConfiguration

default PutBucketInventoryConfigurationResponse putBucketInventoryConfiguration(PutBucketInventoryConfigurationRequest putBucketInventoryConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Adds an inventory configuration (identified by the inventory ID) from the bucket.

Parameters:: putBucketInventoryConfigurationRequest -
Returns:: Result of the PutBucketInventoryConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketLifecycle

default PutBucketLifecycleResponse putBucketLifecycle(PutBucketLifecycleRequest putBucketLifecycleRequest)
                                               throws SdkBaseException,
                                                      SdkClientException,
                                                      S3Exception

Deprecated, see the PutBucketLifecycleConfiguration operation.

Parameters:: putBucketLifecycleRequest -
Returns:: Result of the PutBucketLifecycle operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketLifecycleConfiguration

default PutBucketLifecycleConfigurationResponse putBucketLifecycleConfiguration(PutBucketLifecycleConfigurationRequest putBucketLifecycleConfigurationRequest)
                                                                         throws SdkBaseException,
                                                                                SdkClientException,
                                                                                S3Exception

Sets lifecycle configuration for your bucket. If a lifecycle configuration exists, it replaces it.

Parameters:: putBucketLifecycleConfigurationRequest -
Returns:: Result of the PutBucketLifecycleConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketLogging

default PutBucketLoggingResponse putBucketLogging(PutBucketLoggingRequest putBucketLoggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. To set the logging status of a bucket, you must be the bucket owner.

Parameters:: putBucketLoggingRequest -
Returns:: Result of the PutBucketLogging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketMetricsConfiguration

default PutBucketMetricsConfigurationResponse putBucketMetricsConfiguration(PutBucketMetricsConfigurationRequest putBucketMetricsConfigurationRequest)
                                                                     throws SdkBaseException,
                                                                            SdkClientException,
                                                                            S3Exception

Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.

Parameters:: putBucketMetricsConfigurationRequest -
Returns:: Result of the PutBucketMetricsConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketNotification

default PutBucketNotificationResponse putBucketNotification(PutBucketNotificationRequest putBucketNotificationRequest)
                                                     throws SdkBaseException,
                                                            SdkClientException,
                                                            S3Exception

Deprecated, see the PutBucketNotificationConfiguraiton operation.

Parameters:: putBucketNotificationRequest -
Returns:: Result of the PutBucketNotification operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketNotificationConfiguration

default PutBucketNotificationConfigurationResponse putBucketNotificationConfiguration(PutBucketNotificationConfigurationRequest putBucketNotificationConfigurationRequest)
                                                                               throws SdkBaseException,
                                                                                      SdkClientException,
                                                                                      S3Exception

Enables notifications of specified events for a bucket.

Parameters:: putBucketNotificationConfigurationRequest -
Returns:: Result of the PutBucketNotificationConfiguration operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketPolicy

default PutBucketPolicyResponse putBucketPolicy(PutBucketPolicyRequest putBucketPolicyRequest)
                                         throws SdkBaseException,
                                                SdkClientException,
                                                S3Exception

Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.

Parameters:: putBucketPolicyRequest -
Returns:: Result of the PutBucketPolicy operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketReplication

default PutBucketReplicationResponse putBucketReplication(PutBucketReplicationRequest putBucketReplicationRequest)
                                                   throws SdkBaseException,
                                                          SdkClientException,
                                                          S3Exception

Creates a new replication configuration (or replaces an existing one, if present).

Parameters:: putBucketReplicationRequest -
Returns:: Result of the PutBucketReplication operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketRequestPayment
```
default PutBucketRequestPaymentResponse putBucketRequestPayment(PutBucketRequestPaymentRequest putBucketRequestPaymentRequest)
                                                         throws SdkBaseException,
                                                                SdkClientException,
                                                                S3Exception
```
Sets the request payment configuration for a bucket. By default, the bucket owner pays for downloads from the bucket. This configuration parameter enables the bucket owner (only) to specify that the person requesting the download will be charged for the download. Documentation on requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html

Parameters:

putBucketRequestPaymentRequest -

Returns:

Result of the PutBucketRequestPayment operation returned by the service.

Throws:

SdkBaseException

SdkClientException

S3Exception

putBucketTagging

default PutBucketTaggingResponse putBucketTagging(PutBucketTaggingRequest putBucketTaggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Sets the tags for a bucket.

Parameters:: putBucketTaggingRequest -
Returns:: Result of the PutBucketTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketVersioning

default PutBucketVersioningResponse putBucketVersioning(PutBucketVersioningRequest putBucketVersioningRequest)
                                                 throws SdkBaseException,
                                                        SdkClientException,
                                                        S3Exception

Sets the versioning state of an existing bucket. To set the versioning state, you must be the bucket owner.

Parameters:: putBucketVersioningRequest -
Returns:: Result of the PutBucketVersioning operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putBucketWebsite

default PutBucketWebsiteResponse putBucketWebsite(PutBucketWebsiteRequest putBucketWebsiteRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Set the website configuration for a bucket.

Parameters:: putBucketWebsiteRequest -
Returns:: Result of the PutBucketWebsite operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

putObject
```
default PutObjectResponse putObject(PutObjectRequest putObjectRequest,
                                    RequestBody requestBody)
                             throws SdkBaseException,
                                    SdkClientException,
                                    S3Exception
```
Adds an object to a bucket.
Parameters:

putObjectRequest -
requestBody - The content to send to the service. A RequestBody can be created using one of several factory methods for various sources of data. For example, to create a request body from a file you can do the following.
```
 RequestBody.of(new File("myfile.txt"))
 
```
See documentation in RequestBody for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Object data.'.
Returns:

Result of the PutObject operation returned by the service.

Throws:

SdkBaseException

SdkClientException

S3Exception

putObjectAcl
```
default PutObjectAclResponse putObjectAcl(PutObjectAclRequest putObjectAclRequest)
                                   throws NoSuchKeyException,
                                          SdkBaseException,
                                          SdkClientException,
                                          S3Exception
```
uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket

Parameters:

putObjectAclRequest -

Returns:

Result of the PutObjectAcl operation returned by the service.

Throws:

NoSuchKeyException - The specified key does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

putObjectTagging

default PutObjectTaggingResponse putObjectTagging(PutObjectTaggingRequest putObjectTaggingRequest)
                                           throws SdkBaseException,
                                                  SdkClientException,
                                                  S3Exception

Sets the supplied tag-set to an object that already exists in a bucket

Parameters:: putObjectTaggingRequest -
Returns:: Result of the PutObjectTagging operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

restoreObject
```
default RestoreObjectResponse restoreObject(RestoreObjectRequest restoreObjectRequest)
                                     throws ObjectAlreadyInActiveTierErrorException,
                                            SdkBaseException,
                                            SdkClientException,
                                            S3Exception
```
Restores an archived copy of an object back into Amazon S3

Parameters:

restoreObjectRequest -

Returns:

Result of the RestoreObject operation returned by the service.

Throws:

ObjectAlreadyInActiveTierErrorException - This operation is not allowed against this storage tier

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

S3Exception - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

uploadPart
```
default UploadPartResponse uploadPart(UploadPartRequest uploadPartRequest,
                                      RequestBody requestBody)
                               throws SdkBaseException,
                                      SdkClientException,
                                      S3Exception
```
Uploads a part in a multipart upload.

Note: After you initiate multipart upload and upload one or more parts, you must either complete or abort multipart upload in order to stop getting charged for storage of the uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts storage.
Parameters:

uploadPartRequest -
requestBody - The content to send to the service. A RequestBody can be created using one of several factory methods for various sources of data. For example, to create a request body from a file you can do the following.
```
 RequestBody.of(new File("myfile.txt"))
 
```
See documentation in RequestBody for additional details and which sources of data are supported. The service documentation for the request content is as follows 'Object data.'.
Returns:

Result of the UploadPart operation returned by the service.

Throws:

SdkBaseException

SdkClientException

S3Exception

uploadPartCopy

default UploadPartCopyResponse uploadPartCopy(UploadPartCopyRequest uploadPartCopyRequest)
                                       throws SdkBaseException,
                                              SdkClientException,
                                              S3Exception

Uploads a part by copying data from an existing object as data source.

Parameters:: uploadPartCopyRequest -
Returns:: Result of the UploadPartCopy operation returned by the service.
Throws:: SdkBaseException; SdkClientException; S3Exception

serviceMetadata

static ServiceMetadata serviceMetadata()

Interface S3Client

Field Summary