Deprecated API

Contents

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

Deprecated Interfaces

Interface and Description
com.amazonaws.services.s3.model.ProgressListener Use ProgressListener instead. Using this class is dangerous as it uses the deprecated ProgressEvent, which performs an unsafe cast from long to int in ProgressEvent.getBytesTransfered().

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(). This method SHOULD NEVER be used as it can lead to integer overflow if the number of bytes transferred was greater than Integer.MAX_VALUE.
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.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterials, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentials, EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration, RequestMetricCollector) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSCredentialsProvider, EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(AWSKMSClient, AWSCredentialsProvider, EncryptionMaterialsProvider, ClientConfiguration, CryptoConfiguration, RequestMetricCollector) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AwsClientBuilder.withCredentials(AWSCredentialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration) and AwsClientBuilder.withClientConfiguration(ClientConfiguration) and AwsClientBuilder.withMetricsCollector(RequestMetricCollector) and AmazonS3EncryptionClientBuilder.withKmsClient(AWSKMS)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterials) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterials, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterialsProvider) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider)
com.amazonaws.services.s3.AmazonS3EncryptionClient(EncryptionMaterialsProvider, CryptoConfiguration) use AmazonS3EncryptionClientBuilder.withEncryptionMaterials(EncryptionMaterialsProvider) and AmazonS3EncryptionClientBuilder.withCryptoConfiguration(CryptoConfiguration)
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();