Class AWSApplicationAutoScalingClient
- java.lang.Object
-
- com.amazonaws.AmazonWebServiceClient
-
- com.amazonaws.services.applicationautoscaling.AWSApplicationAutoScalingClient
-
- All Implemented Interfaces:
AWSApplicationAutoScaling
- Direct Known Subclasses:
AWSApplicationAutoScalingAsyncClient
@ThreadSafe public class AWSApplicationAutoScalingClient extends AmazonWebServiceClient implements AWSApplicationAutoScaling
Client for accessing Application Auto Scaling. All service calls made using this client are blocking, and will not return until the service call completes.Application Auto Scaling is a general purpose Auto Scaling service for supported elastic AWS resources. With Application Auto Scaling, you can automatically scale your AWS resources, with an experience similar to that of Auto Scaling.
At this time, Application Auto Scaling only supports scaling Amazon ECS services.
For example, you can use Application Auto Scaling to accomplish the following tasks:
-
Define scaling policies for automatically adjusting your application’s resources
-
Scale your resources in response to CloudWatch alarms
-
View history of your scaling events
-
-
Field Summary
Fields Modifier and Type Field Description protected static ClientConfigurationFactory
configFactory
Client configuration factory providing ClientConfigurations tailored to this client-
Fields inherited from class com.amazonaws.AmazonWebServiceClient
client, clientConfiguration, endpoint, LOGGING_AWS_REQUEST_METRIC, requestHandler2s, timeOffset
-
-
Constructor Summary
Constructors Constructor Description AWSApplicationAutoScalingClient()
Constructs a new client to invoke service methods on Application Auto Scaling.AWSApplicationAutoScalingClient(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials.AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider.AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider and client configuration options.AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider, client configuration options, and request metric collector.AWSApplicationAutoScalingClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials and client configuration options.AWSApplicationAutoScalingClient(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description DeleteScalingPolicyResult
deleteScalingPolicy(DeleteScalingPolicyRequest deleteScalingPolicyRequest)
Deletes an Application Auto Scaling scaling policy that was previously created.DeregisterScalableTargetResult
deregisterScalableTarget(DeregisterScalableTargetRequest deregisterScalableTargetRequest)
Deregisters a scalable target that was previously registered.DescribeScalableTargetsResult
describeScalableTargets(DescribeScalableTargetsRequest describeScalableTargetsRequest)
Provides descriptive information for scalable targets with a specified service namespace.DescribeScalingActivitiesResult
describeScalingActivities(DescribeScalingActivitiesRequest describeScalingActivitiesRequest)
Provides descriptive information for scaling activities with a specified service namespace.DescribeScalingPoliciesResult
describeScalingPolicies(DescribeScalingPoliciesRequest describeScalingPoliciesRequest)
Provides descriptive information for scaling policies with a specified service namespace.ResponseMetadata
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.PutScalingPolicyResult
putScalingPolicy(PutScalingPolicyRequest putScalingPolicyRequest)
Creates or updates a policy for an existing Application Auto Scaling scalable target.RegisterScalableTargetResult
registerScalableTarget(RegisterScalableTargetRequest registerScalableTargetRequest)
Registers or updates a scalable target.-
Methods inherited from class com.amazonaws.AmazonWebServiceClient
addRequestHandler, addRequestHandler, beforeMarshalling, configureRegion, createExecutionContext, createExecutionContext, createExecutionContext, endClientExecution, endClientExecution, findRequestMetricCollector, getEndpointPrefix, getRequestMetricsCollector, getServiceAbbreviation, getServiceName, getServiceNameIntern, getSigner, getSignerByURI, getSignerRegionOverride, getTimeOffset, isProfilingEnabled, isRequestMetricsEnabled, removeRequestHandler, removeRequestHandler, requestMetricCollector, setEndpoint, setEndpointPrefix, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface com.amazonaws.services.applicationautoscaling.AWSApplicationAutoScaling
setEndpoint, setRegion, shutdown
-
-
-
-
Field Detail
-
configFactory
protected static final ClientConfigurationFactory configFactory
Client configuration factory providing ClientConfigurations tailored to this client
-
-
Constructor Detail
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient()
Constructs a new client to invoke service methods on Application Auto Scaling. A credentials provider chain will be used that searches for credentials in this order:- Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
- Java System Properties - aws.accessKeyId and aws.secretKey
- Instance profile credentials delivered through the Amazon EC2 metadata service
All service calls made using this new client object are blocking, and will not return until the service call completes.
- See Also:
DefaultAWSCredentialsProviderChain
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling. A credentials provider chain will be used that searches for credentials in this order:- Environment Variables - AWS_ACCESS_KEY_ID and AWS_SECRET_KEY
- Java System Properties - aws.accessKeyId and aws.secretKey
- Instance profile credentials delivered through the Amazon EC2 metadata service
All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
clientConfiguration
- The client configuration options controlling how this client connects to Application Auto Scaling (ex: proxy settings, retry counts, etc.).- See Also:
DefaultAWSCredentialsProviderChain
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(AWSCredentials awsCredentials)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials.All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(AWSCredentials awsCredentials, ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials and client configuration options.All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
awsCredentials
- The AWS credentials (access key ID and secret key) to use when authenticating with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Application Auto Scaling (ex: proxy settings, retry counts, etc.).
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider.All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider and client configuration options.All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Application Auto Scaling (ex: proxy settings, retry counts, etc.).
-
AWSApplicationAutoScalingClient
public AWSApplicationAutoScalingClient(AWSCredentialsProvider awsCredentialsProvider, ClientConfiguration clientConfiguration, RequestMetricCollector requestMetricCollector)
Constructs a new client to invoke service methods on Application Auto Scaling using the specified AWS account credentials provider, client configuration options, and request metric collector.All service calls made using this new client object are blocking, and will not return until the service call completes.
- Parameters:
awsCredentialsProvider
- The AWS credentials provider which will provide credentials to authenticate requests with AWS services.clientConfiguration
- The client configuration options controlling how this client connects to Application Auto Scaling (ex: proxy settings, retry counts, etc.).requestMetricCollector
- optional request metric collector
-
-
Method Detail
-
deleteScalingPolicy
public DeleteScalingPolicyResult deleteScalingPolicy(DeleteScalingPolicyRequest deleteScalingPolicyRequest)
Deletes an Application Auto Scaling scaling policy that was previously created. If you are no longer using a scaling policy, you can delete it with this operation.
Deleting a policy deletes the underlying alarm action, but does not delete the CloudWatch alarm, even if it no longer has an associated action.
To create a new scaling policy or update an existing one, see PutScalingPolicy.
- Specified by:
deleteScalingPolicy
in interfaceAWSApplicationAutoScaling
- Parameters:
deleteScalingPolicyRequest
-- Returns:
- Result of the DeleteScalingPolicy operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.ObjectNotFoundException
- The specified object could not be found. For anyPut
orRegister
API operation, which depends on the existence of a scalable target, this exception is thrown if the scalable target with the specified service namespace, resource ID, and scalable dimension does not exist. For anyDelete
orDeregister
API operation, this exception is thrown if the resource that is to be deleted or deregistered cannot be found.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
deregisterScalableTarget
public DeregisterScalableTargetResult deregisterScalableTarget(DeregisterScalableTargetRequest deregisterScalableTargetRequest)
Deregisters a scalable target that was previously registered. If you are no longer using a scalable target, you can delete it with this operation. When you deregister a scalable target, all of the scaling policies that are associated with that scalable target are deleted.
To create a new scalable target or update an existing one, see RegisterScalableTarget.
- Specified by:
deregisterScalableTarget
in interfaceAWSApplicationAutoScaling
- Parameters:
deregisterScalableTargetRequest
-- Returns:
- Result of the DeregisterScalableTarget operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.ObjectNotFoundException
- The specified object could not be found. For anyPut
orRegister
API operation, which depends on the existence of a scalable target, this exception is thrown if the scalable target with the specified service namespace, resource ID, and scalable dimension does not exist. For anyDelete
orDeregister
API operation, this exception is thrown if the resource that is to be deleted or deregistered cannot be found.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
describeScalableTargets
public DescribeScalableTargetsResult describeScalableTargets(DescribeScalableTargetsRequest describeScalableTargetsRequest)
Provides descriptive information for scalable targets with a specified service namespace.
You can filter the results in a service namespace with the
ResourceIds
andScalableDimension
parameters.To create a new scalable target or update an existing one, see RegisterScalableTarget. If you are no longer using a scalable target, you can deregister it with DeregisterScalableTarget.
- Specified by:
describeScalableTargets
in interfaceAWSApplicationAutoScaling
- Parameters:
describeScalableTargetsRequest
-- Returns:
- Result of the DescribeScalableTargets operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.InvalidNextTokenException
- The next token supplied was invalid.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
describeScalingActivities
public DescribeScalingActivitiesResult describeScalingActivities(DescribeScalingActivitiesRequest describeScalingActivitiesRequest)
Provides descriptive information for scaling activities with a specified service namespace.
You can filter the results in a service namespace with the
ResourceId
andScalableDimension
parameters.Scaling activities are triggered by CloudWatch alarms that are associated with scaling policies. To view the existing scaling policies for a service namespace, see DescribeScalingPolicies. To create a new scaling policy or update an existing one, see PutScalingPolicy.
- Specified by:
describeScalingActivities
in interfaceAWSApplicationAutoScaling
- Parameters:
describeScalingActivitiesRequest
-- Returns:
- Result of the DescribeScalingActivities operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.InvalidNextTokenException
- The next token supplied was invalid.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
describeScalingPolicies
public DescribeScalingPoliciesResult describeScalingPolicies(DescribeScalingPoliciesRequest describeScalingPoliciesRequest)
Provides descriptive information for scaling policies with a specified service namespace.
You can filter the results in a service namespace with the
ResourceId
,ScalableDimension
, andPolicyNames
parameters.To create a new scaling policy or update an existing one, see PutScalingPolicy. If you are no longer using a scaling policy, you can delete it with DeleteScalingPolicy.
- Specified by:
describeScalingPolicies
in interfaceAWSApplicationAutoScaling
- Parameters:
describeScalingPoliciesRequest
-- Returns:
- Result of the DescribeScalingPolicies operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.FailedResourceAccessException
- Failed access to resources caused an exception. This exception currently only applies to DescribeScalingPolicies. It is thrown when Application Auto Scaling is unable to retrieve the alarms associated with a scaling policy due to a client error, for example, if the role ARN specified for a scalable target does not have the proper permissions to call the CloudWatch DescribeAlarms API operation on behalf of your account.InvalidNextTokenException
- The next token supplied was invalid.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
putScalingPolicy
public PutScalingPolicyResult putScalingPolicy(PutScalingPolicyRequest putScalingPolicyRequest)
Creates or updates a policy for an existing Application Auto Scaling scalable target. Each scalable target is identified by service namespace, a resource ID, and a scalable dimension, and a scaling policy applies to a scalable target that is identified by those three attributes. You cannot create a scaling policy without first registering a scalable target with RegisterScalableTarget.
To update an existing policy, use the existing policy name and set the parameters you want to change. Any existing parameter not changed in an update to an existing policy is not changed in this update request.
You can view the existing scaling policies for a service namespace with DescribeScalingPolicies. If you are no longer using a scaling policy, you can delete it with DeleteScalingPolicy.
- Specified by:
putScalingPolicy
in interfaceAWSApplicationAutoScaling
- Parameters:
putScalingPolicyRequest
-- Returns:
- Result of the PutScalingPolicy operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.LimitExceededException
- Your account exceeded a limit. This exception is thrown when a per-account resource limit is exceeded. Application Auto Scaling has a limit of 40 scalable targets per account for Amazon ECS services, 50 scaling policies per scalable target, and 20 step adjustments per step scaling policy.ObjectNotFoundException
- The specified object could not be found. For anyPut
orRegister
API operation, which depends on the existence of a scalable target, this exception is thrown if the scalable target with the specified service namespace, resource ID, and scalable dimension does not exist. For anyDelete
orDeregister
API operation, this exception is thrown if the resource that is to be deleted or deregistered cannot be found.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
registerScalableTarget
public RegisterScalableTargetResult registerScalableTarget(RegisterScalableTargetRequest registerScalableTargetRequest)
Registers or updates a scalable target. A scalable target is a resource that can be scaled up or down with Application Auto Scaling. After you have registered a scalable target, you can use this command to update the minimum and maximum values for your scalable dimension.
At this time, Application Auto Scaling only supports scaling Amazon ECS services.
After you register a scalable target with Application Auto Scaling, you can create and apply scaling policies to it with PutScalingPolicy. You can view the existing scaling policies for a service namespace with DescribeScalableTargets. If you are no longer using a scalable target, you can deregister it with DeregisterScalableTarget.
- Specified by:
registerScalableTarget
in interfaceAWSApplicationAutoScaling
- Parameters:
registerScalableTargetRequest
-- Returns:
- Result of the RegisterScalableTarget operation returned by the service.
- Throws:
ValidationException
- An exception was thrown for a validation issue. Review the available parameters for the API request.LimitExceededException
- Your account exceeded a limit. This exception is thrown when a per-account resource limit is exceeded. Application Auto Scaling has a limit of 40 scalable targets per account for Amazon ECS services, 50 scaling policies per scalable target, and 20 step adjustments per step scaling policy.ConcurrentUpdateException
- Concurrent updates caused an exception, for example, if you request an update to an Application Auto Scaling resource that already has a pending update.InternalServiceException
- The service encountered an internal error.
-
getCachedResponseMetadata
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
- Specified by:
getCachedResponseMetadata
in interfaceAWSApplicationAutoScaling
- Parameters:
request
- The originally executed request- Returns:
- The response metadata for the specified request, or null if none is available.
-
-