Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

Interface and Description
com.amazonaws.services.s3.model.ProgressListener Replaced by ProgressListener.

Deprecated Classes

Class and Description
com.amazonaws.services.s3.model.BucketNotificationConfiguration.TopicConfiguration Use TopicConfiguration instead
com.amazonaws.services.s3.model.CloudFunctionConfiguration use LambdaConfiguration instead
com.amazonaws.services.s3.model.LegacyS3ProgressListener
com.amazonaws.services.s3.model.ProgressEvent Replaced by ProgressEvent

Deprecated Fields

Field and Description
com.amazonaws.services.s3.model.InstructionFileId.DEFAULT_INSTURCTION_FILE_SUFFIX

Deprecated Methods

Method and Description
com.amazonaws.services.s3.model.NotificationConfiguration.addObjectPrefix(String) This field is not used by S3. It will be removed in the next major version of the SDK
com.amazonaws.services.s3.transfer.Transfer.addProgressListener(ProgressListener) Replaced by Transfer.addProgressListener(ProgressListener)
com.amazonaws.services.s3.AmazonS3.changeObjectStorageClass(String, String, StorageClass) this operation will not retain the ACL's or SSE parameters associated with the given Amazon S3 object. Use AmazonS3.copyObject(CopyObjectRequest) instead.
com.amazonaws.services.s3.AmazonS3Client.createBucket(String, Region)
com.amazonaws.services.s3.AmazonS3.createBucket(String, Region) Use regional endpoint and call AmazonS3.createBucket(String) instead.
com.amazonaws.services.s3.AmazonS3Client.createBucket(String, String)
com.amazonaws.services.s3.AmazonS3.createBucket(String, String) Use regional endpoint and call AmazonS3.createBucket(String) instead.
com.amazonaws.services.s3.S3ClientOptions.disableChunkedEncoding() Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.getBucket() Use getBucketName() instead.
com.amazonaws.services.s3.model.GenericBucketRequest.getBucket() Use getBucketName() instead.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.getBucketNotificationConfiguration() Use getNotificationConfiguration() instead.
com.amazonaws.services.s3.transfer.TransferProgress.getBytesTransfered() Replaced by TransferProgress.getBytesTransferred()
com.amazonaws.services.s3.model.ProgressEvent.getBytesTransfered() Replaced by ProgressEvent.getBytesTransferred()
com.amazonaws.services.s3.model.BucketNotificationConfiguration.TopicConfiguration.getEvent() use NotificationConfiguration.getEvents() instead.
com.amazonaws.services.s3.model.AccessControlList.getGrants() This will remove the duplicate grants if received from Amazon S3. Use AccessControlList.getGrantsAsList() instead.
com.amazonaws.services.s3.model.CryptoConfiguration.getKmsRegion()
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getNoncurrentVersionTransition()
com.amazonaws.services.s3.model.NotificationConfiguration.getObjectPrefixes() This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.getFilter() for the correct way to filter notifications.
com.amazonaws.services.s3.transfer.TransferProgress.getPercentTransfered() Replaced by TransferProgress.getPercentTransferred()
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getPrefix() The method returns prefix only if was was set using BucketLifecycleConfiguration.Rule.setPrefix(String). Otherwise, Use LifecycleFilter.
com.amazonaws.services.s3.model.GetObjectRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.UploadPartRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.AbstractPutObjectRequest.getProgressListener() use AmazonWebServiceRequest.getGeneralProgressListener() instead.
com.amazonaws.services.s3.model.CreateBucketRequest.getRegion()
com.amazonaws.services.s3.model.ObjectMetadata.getServerSideEncryption() Replaced by ObjectMetadata.getSSEAlgorithm()
com.amazonaws.services.s3.event.S3EventNotification.S3ObjectEntity.getSize() use S3EventNotification.S3ObjectEntity.getSizeAsLong() instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Transition.getStorageClass() This method should not be used. Use BucketLifecycleConfiguration.Transition.getStorageClassAsString() instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.NoncurrentVersionTransition.getStorageClass() This method should not be used. Use BucketLifecycleConfiguration.NoncurrentVersionTransition.getStorageClassAsString() instead.
com.amazonaws.services.s3.model.BucketNotificationConfiguration.getTopicConfigurations()
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.getTransition()
com.amazonaws.services.s3.transfer.Transfer.removeProgressListener(ProgressListener) Replaced by Transfer.removeProgressListener(ProgressListener)
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.setBucket(String) Use setBucketName(String) instead.
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest.setBucketNotificationConfiguration(BucketNotificationConfiguration) Use setNotificationConfiguration(BucketNotificationConfiguration) instead.
com.amazonaws.services.s3.S3ClientOptions.setChunkedEncodingDisabled(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.transfer.TransferManager.setConfiguration(TransferManagerConfiguration) use appropriate method on the TransferManagerBuilder for example: TransferManagerBuilder.standard().withMinimumUploadPartSize(100L).build();
com.amazonaws.services.s3.AmazonS3Client.setEndpoint(String) use AwsClientBuilder.setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration)
com.amazonaws.services.s3.model.CryptoConfiguration.setKmsRegion(Regions)
com.amazonaws.services.s3.transfer.TransferManagerConfiguration.setMultipartUploadThreshold(int) replaced by TransferManagerConfiguration.setMultipartUploadThreshold(long)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setNoncurrentVersionTransition(BucketLifecycleConfiguration.NoncurrentVersionTransition)
com.amazonaws.services.s3.model.NotificationConfiguration.setObjectPrefixes(List<String>) This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.setFilter(Filter) for the correct way to filter notifications.
com.amazonaws.services.s3.AmazonS3.setObjectRedirectLocation(String, String, String) this operation will not retain the ACL's or SSE parameters associated with the given Amazon S3 object. Use AmazonS3.copyObject(CopyObjectRequest) instead.
com.amazonaws.services.s3.S3ClientOptions.setPathStyleAccess(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setPrefix(String) Use LifecycleFilter instead.
com.amazonaws.services.s3.model.GetObjectRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.UploadPartRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.AbstractPutObjectRequest.setProgressListener(ProgressListener) use AmazonWebServiceRequest.setGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.AmazonS3Client.setRegion(Region) use AwsClientBuilder.setRegion(String)
com.amazonaws.services.s3.model.CreateBucketRequest.setRegion(String) Use regional client instead to create bucket in that region.
com.amazonaws.services.s3.model.ObjectMetadata.setServerSideEncryption(String) Replaced by ObjectMetadata.setSSEAlgorithm(String)
com.amazonaws.services.s3.model.BucketNotificationConfiguration.setTopicConfigurations(Collection<BucketNotificationConfiguration.TopicConfiguration>)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.setTransition(BucketLifecycleConfiguration.Transition)
com.amazonaws.services.s3.S3ClientOptions.withChunkedEncodingDisabled(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.CryptoConfiguration.withKmsRegion(Regions)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withNoncurrentVersionTransition(BucketLifecycleConfiguration.NoncurrentVersionTransition)
com.amazonaws.services.s3.model.NotificationConfiguration.withObjectPrefixes(String...) This field is not used by S3. It will be removed in the next major version of the SDK. See NotificationConfiguration.withFilter(Filter) for the correct way to filter notifications.
com.amazonaws.services.s3.S3ClientOptions.withPathStyleAccess(boolean) Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withPrefix(String) Use LifecycleFilter instead.
com.amazonaws.services.s3.model.GetObjectRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.UploadPartRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.PutObjectRequest.withProgressListener(ProgressListener)
com.amazonaws.services.s3.model.AbstractPutObjectRequest.withProgressListener(ProgressListener) use AmazonWebServiceRequest.withGeneralProgressListener(ProgressListener) instead.
com.amazonaws.services.s3.model.BucketNotificationConfiguration.withTopicConfigurations(BucketNotificationConfiguration.TopicConfiguration...)
com.amazonaws.services.s3.model.BucketLifecycleConfiguration.Rule.withTransition(BucketLifecycleConfiguration.Transition)

Deprecated Constructors

Constructor and Description
com.amazonaws.services.s3.AmazonS3Client() use AmazonS3ClientBuilder.defaultClient()
com.amazonaws.services.s3.AmazonS3Client(AWSCredentials) use AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentials, ClientConfiguration) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider) use AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider, ClientConfiguration) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3Client(AWSCredentialsProvider, ClientConfiguration, RequestMetricCollector) use AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
com.amazonaws.services.s3.AmazonS3Client(ClientConfiguration) use AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.model.BucketNotificationConfiguration(Collection<BucketNotificationConfiguration.TopicConfiguration>)
com.amazonaws.services.s3.S3ClientOptions() Use S3ClientOptions.builder() to build new S3ClientOptions instead.
com.amazonaws.services.s3.S3ClientOptions(S3ClientOptions) Will be removed once S3ClientOptions is made an immutable class.
com.amazonaws.services.s3.event.S3EventNotification.S3ObjectEntity(String, Integer, String, String)
com.amazonaws.services.s3.model.SetBucketNotificationConfigurationRequest(BucketNotificationConfiguration, String) Use SetBucketNotificationConfigurationRequest(String, BucketNotificationConfiguration) instead.
com.amazonaws.services.s3.transfer.TransferManager() use TransferManagerBuilder.defaultTransferManager()
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3) use TransferManagerBuilder.withS3Client(AmazonS3)
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3, ExecutorService) use TransferManagerBuilder.withS3Client(AmazonS3) and TransferManagerBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory)
com.amazonaws.services.s3.transfer.TransferManager(AmazonS3, ExecutorService, boolean) use TransferManagerBuilder.withS3Client(AmazonS3) and TransferManagerBuilder.withExecutorFactory(com.amazonaws.client.builder.ExecutorFactory) and TransferManagerBuilder.withShutDownThreadPools(Boolean)
com.amazonaws.services.s3.transfer.TransferManager(AWSCredentials) use TransferManagerBuilder.withS3Client(AmazonS3) for example: TransferManagerBuilder.standard().withS3Client(AmazonS3ClientBuilder.standard.withCredentials(credentials).build()).build();
com.amazonaws.services.s3.transfer.TransferManager(AWSCredentialsProvider) use TransferManagerBuilder.withS3Client(AmazonS3) for example: TransferManagerBuilder.standard().withS3Client(AmazonS3ClientBuilder.standard.withCredentials(credentialsProvider).build()).build();