Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
com.amazonaws.handlers.RequestHandler by RequestHandler2. Interface for addition request handling in clients. A request handler is executed on a request object before it is sent to the client runtime to be executed.
com.amazonaws.protocol.json.SdkJsonMarshallerFactory By ProtocolRequestMarshaller

Deprecated Classes

Class and Description
com.amazonaws.handlers.AbstractRequestHandler by RequestHandler2. Simple implementation of RequestHandler to stub out required methods.
com.amazonaws.handlers.CredentialsRequestHandler Use of this class to retrieve the credentials is unsafe in multithreading scenarios. If a client is used across multiple threads, there's a possibility of running into a race condition where one handler might access the credentials through the reference as another thread is updating it. Retrieve the credentials from the handler context instead using the HandlerContextKey.AWS_CREDENTIALS key.
com.amazonaws.internal.EC2MetadataClient Refer EC2MetadataUtils
com.amazonaws.regions.LegacyRegionXmlLoadUtils
com.amazonaws.auth.profile.internal.Profile
com.amazonaws.regions.ServiceAbbreviations use the constant ENDPOINT_PREFIX from the specific service client interface instead for retrieving the specific service abbreviation, e.g. AmazonEC2.ENDPOINT_PREFIX.
com.amazonaws.internal.StaticCredentialsProvider By AWSStaticCredentialsProvider

Deprecated Fields

Field and Description
com.amazonaws.metrics.AwsSdkMetrics.AWS_CREDENTAIL_PROPERTIES_FILE in favor of AWS_CREDENTIAL_PROPERTIES_FILE
com.amazonaws.auth.profile.ProfilesConfigFile.AWS_PROFILE_ENVIRONMENT_VARIABLE
com.amazonaws.auth.profile.ProfilesConfigFile.AWS_PROFILE_SYSTEM_PROPERTY
com.amazonaws.event.ProgressEvent.CANCELED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_CANCELED_EVENT
com.amazonaws.event.ProgressEvent.COMPLETED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_COMPLETED_EVENT
com.amazonaws.auth.AWS3Signer.dateUtils
com.amazonaws.auth.profile.ProfilesConfigFile.DEFAULT_PROFILE_NAME
com.amazonaws.SDKGlobalConfiguration.DEFAULT_S3_STREAM_BUFFER_SIZE with AmazonWebServiceRequest.getRequestClientOptions() and RequestClientOptions.setReadLimit(int). The default size of the buffer when uploading data from a stream. A buffer of this size will be created and filled with the first bytes from a stream being uploaded so that any transmit errors that occur in that section of the data can be automatically retried without the caller's intervention. If not set, the default value of 128 KB will be used.
com.amazonaws.SDKGlobalConfiguration.ENABLE_S3_SIGV4_SYSTEM_PROPERTY
com.amazonaws.SDKGlobalConfiguration.ENFORCE_S3_SIGV4_SYSTEM_PROPERTY
com.amazonaws.event.ProgressEvent.FAILED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_FAILED_EVENT
com.amazonaws.AmazonWebServiceClient.LOGGING_AWS_REQUEST_METRIC No longer used.
com.amazonaws.event.ProgressEvent.PART_COMPLETED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_PART_COMPLETED_EVENT
com.amazonaws.event.ProgressEvent.PART_FAILED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_PART_FAILED_EVENT
com.amazonaws.event.ProgressEvent.PART_STARTED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_PART_STARTED_EVENT
com.amazonaws.event.ProgressEvent.PREPARING_EVENT_CODE Replaced by ProgressEventType.TRANSFER_PREPARING_EVENT
com.amazonaws.SDKGlobalConfiguration.PROFILING_SYSTEM_PROPERTY by SDKGlobalConfiguration.DEFAULT_METRICS_SYSTEM_PROPERTY. Internal system property to enable timing info collection.
com.amazonaws.event.ProgressEvent.RESET_EVENT_CODE Replaced by ProgressEventType.HTTP_REQUEST_CONTENT_RESET_EVENT
com.amazonaws.util.EC2MetadataUtils.IAMSecurityCredential.secretAcessKey because it is spelled incorrectly
com.amazonaws.event.ProgressEvent.STARTED_EVENT_CODE Replaced by ProgressEventType.TRANSFER_STARTED_EVENT

Deprecated Methods

Method and Description
com.amazonaws.AmazonWebServiceClient.addRequestHandler(RequestHandler) by AmazonWebServiceClient.addRequestHandler(RequestHandler2). Appends a request handler to the list of registered handlers that are run as part of a request's lifecycle.
com.amazonaws.AmazonWebServiceClient.addRequestHandler(RequestHandler2) use AwsClientBuilder.withRequestHandlers(RequestHandler2...)
com.amazonaws.AmazonWebServiceClient.configureRegion(Regions) use AwsClientBuilder.setRegion(String)
com.amazonaws.regions.Region.createClient(Class<T>, AWSCredentialsProvider, ClientConfiguration) use appropriate AwsClientBuilder implementation for the service being constructed. For example: AmazonSNSClientBuilder.standard().withRegion(region).build();
com.amazonaws.protocol.json.SdkStructuredJsonFactory.createErrorResponseHandler(List<JsonErrorUnmarshaller>, String) Use SdkStructuredJsonFactory.createErrorResponseHandler(JsonErrorResponseMetadata, List) instead
com.amazonaws.http.AmazonHttpClient.execute(Request<?>, HttpResponseHandler<AmazonWebServiceResponse<T>>, HttpResponseHandler<AmazonServiceException>, ExecutionContext) Use AmazonHttpClient.requestExecutionBuilder() to configure and execute a HTTP request.
com.amazonaws.auth.profile.ProfilesConfigFile.getAllProfiles()
com.amazonaws.protocol.json.StructuredJsonGenerator.getContentType()
com.amazonaws.metrics.AwsSdkMetrics.getCredentailFile() use AwsSdkMetrics.getCredentialFile()
com.amazonaws.util.TimingInfo.getElapsedTimeMillis()
com.amazonaws.util.TimingInfo.getEndEpochTimeMilli()
com.amazonaws.util.TimingInfo.getEndTime()
com.amazonaws.event.ProgressEvent.getEventCode() Use ProgressEvent.getEventType() instead.
com.amazonaws.SDKGlobalConfiguration.getGlobalTimeOffset() by SDKGlobalTime.getGlobalTimeOffset()
com.amazonaws.http.HttpResponse.getHeader(String) See HttpResponse.getHeaderValues(String)
com.amazonaws.http.HttpResponse.getHeaders() See HttpResponse.getAllHeaders()
com.amazonaws.http.SdkHttpMetadata.getHttpHeaders() See SdkHttpMetadata.getAllHttpHeaders()
com.amazonaws.http.response.HttpResponseProxy.getParams()
com.amazonaws.metrics.AwsSdkMetrics.getRegion() Use AwsSdkMetrics.getRegionName()
com.amazonaws.regions.RegionMetadata.getRegionByEndpoint(String) sdk no longer holds the complete endpoint for every service in the region. It now uses the partition metadata to compute the endpoints dynamically for new regions and services.
com.amazonaws.AmazonWebServiceRequest.getRequestCredentials() by AmazonWebServiceRequest.getRequestCredentialsProvider()
com.amazonaws.AmazonWebServiceClient.getServiceAbbreviation() by AmazonWebServiceClient.getServiceName().
com.amazonaws.AmazonWebServiceClient.getSigner()
com.amazonaws.http.ExecutionContext.getSignerByURI(URI)
com.amazonaws.util.TimingInfo.getStartEpochTimeMilli()
com.amazonaws.util.TimingInfo.getStartTime()
com.amazonaws.auth.AbstractAWSSigner.getTimeOffset(SignableRequest<?>)
com.amazonaws.util.TimingInfo.getTimeTakenMillis()
com.amazonaws.ClientConfiguration.getUserAgent() Replaced by ClientConfiguration.getUserAgentPrefix() and ClientConfiguration.getUserAgentSuffix()
com.amazonaws.regions.RegionUtils.init() in favor of RegionUtils.initialize()
com.amazonaws.regions.RegionUtils.initializeFromFile(File)
com.amazonaws.regions.RegionUtils.initializeFromResource(Class<?>, String)
com.amazonaws.regions.RegionUtils.initializeFromResource(ClassLoader, String)
com.amazonaws.regions.RegionUtils.initializeFromResource(String)
com.amazonaws.regions.RegionUtils.initializeFromURI(URI)
com.amazonaws.regions.RegionUtils.initializeFromURI(URI, ClientConfiguration)
com.amazonaws.event.ProgressInputStream.inputStreamForRequest(InputStream, AmazonWebServiceRequest)
com.amazonaws.regions.RegionUtils.loadMetadataFromFile(File)
com.amazonaws.regions.RegionUtils.loadMetadataFromInputStream(InputStream)
com.amazonaws.regions.RegionUtils.loadMetadataFromResource(Class<?>, String)
com.amazonaws.regions.RegionUtils.loadMetadataFromResource(ClassLoader, String)
com.amazonaws.regions.RegionUtils.loadMetadataFromResource(String)
com.amazonaws.regions.RegionUtils.loadMetadataFromURI(URI)
com.amazonaws.regions.RegionUtils.loadMetadataFromURI(URI, ClientConfiguration)
com.amazonaws.AmazonWebServiceClient.makeImmutable()
com.amazonaws.internal.http.JsonErrorMessageParser.parseErrorMessage(JsonNode) By JsonErrorMessageParser.parseErrorMessage(HttpResponse, JsonNode)
com.amazonaws.regions.RegionMetadataParser.parseRegionMetadata(InputStream) in favor of RegionMetadataParser.parse(InputStream)
com.amazonaws.regions.RegionMetadataParser.parseRegionMetadata(InputStream, boolean) in favor of RegionMetadataParser.parse(InputStream)
com.amazonaws.util.AwsHostNameUtils.parseRegionName(String, String) in favor of AwsHostNameUtils.parseRegion(String, String).
com.amazonaws.util.AwsHostNameUtils.parseRegionName(URI) in favor of AwsHostNameUtils.parseRegionName(String, String).
com.amazonaws.util.AwsHostNameUtils.parseServiceName(URI)
com.amazonaws.http.IdleConnectionReaper.registerConnectionManager(HttpClientConnectionManager) By IdleConnectionReaper.registerConnectionManager(HttpClientConnectionManager, long).
com.amazonaws.AmazonWebServiceClient.removeRequestHandler(RequestHandler) use AwsClientBuilder.withRequestHandlers(RequestHandler2...)
com.amazonaws.AmazonWebServiceClient.removeRequestHandler(RequestHandler2) use AwsClientBuilder.withRequestHandlers(RequestHandler2...)
com.amazonaws.util.IdempotentUtils.resolveString(String) By IdempotentUtils.getGenerator()
com.amazonaws.protocol.json.JsonProtocolMarshallerBuilder.sendExplicitNullForPayload(boolean)
com.amazonaws.AmazonWebServiceClient.setEndpoint(String) use AwsClientBuilder.setEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for example: builder.setEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion));
com.amazonaws.AmazonWebServiceClient.setEndpoint(String, String, String) Please use the client builders instead. The AwsClientBuilder.withEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) method on the builder allows setting both endpoint and signing region. See Creating Service Clients for more information.
com.amazonaws.util.TimingInfo.setEndTime(long)
com.amazonaws.SDKGlobalConfiguration.setGlobalTimeOffset(int) by SDKGlobalTime.setGlobalTimeOffset(int)
com.amazonaws.http.response.HttpResponseProxy.setParams(HttpParams)
com.amazonaws.AmazonWebServiceClient.setRegion(Region) use AwsClientBuilder.setRegion(String)
com.amazonaws.AmazonWebServiceRequest.setRequestCredentials(AWSCredentials) by AmazonWebServiceRequest.setRequestCredentialsProvider(AWSCredentialsProvider). If you must use AWSCredentials you can wrap it with a AWSStaticCredentialsProvider.
com.amazonaws.http.ExecutionContext.setSigner(Signer)
com.amazonaws.ClientConfiguration.setUserAgent(String) Replaced by ClientConfiguration.setUserAgentPrefix(String) and ClientConfiguration.setUserAgentSuffix(String)
com.amazonaws.event.SDKProgressPublisher.waitTillCompletion()
com.amazonaws.AmazonWebServiceClient.withEndpoint(String) use AwsClientBuilder.withEndpointConfiguration(AwsClientBuilder.EndpointConfiguration) for example: AmazonSNSClientBuilder.standard().withEndpointConfiguration(new EndpointConfiguration(endpoint, signingRegion)).build();
com.amazonaws.AmazonWebServiceClient.withRegion(Region) use AwsClientBuilder.withRegion(Region) for example: AmazonSNSClientBuilder.standard().withRegion(region).build();
com.amazonaws.AmazonWebServiceClient.withRegion(Regions) use AwsClientBuilder.withRegion(Regions) for example: AmazonSNSClientBuilder.standard().withRegion(region).build();
com.amazonaws.ClientConfiguration.withUserAgent(String) Replaced by ClientConfiguration.withUserAgentPrefix(String) and ClientConfiguration.withUserAgentSuffix(String)

Deprecated Constructors

Constructor and Description
com.amazonaws.auth.ContainerCredentialsProvider() use ContainerCredentialsProvider(CredentialsEndpointProvider)
com.amazonaws.http.ExecutionContext(List<RequestHandler2>, boolean, AmazonWebServiceClient)
com.amazonaws.auth.InstanceProfileCredentialsProvider() for the singleton method InstanceProfileCredentialsProvider.getInstance().
com.amazonaws.event.ProgressEvent(long)
com.amazonaws.regions.RegionMetadataParser() since this object is stateless

Deprecated Enum Constants

Enum Constant and Description
com.amazonaws.event.ProgressEventType.BYTE_TRANSFER_EVENT