AWS Auto Scaling
API Reference (API Version 2018-01-06)


Creates a scaling plan.

A scaling plan contains a set of instructions used to configure dynamic scaling for the scalable resources in your application. AWS Auto Scaling creates target tracking scaling policies based on the scaling instructions in your scaling plan.

Request Syntax

{ "ApplicationSource": { "CloudFormationStackARN": "string", "TagFilters": [ { "Key": "string", "Values": [ "string" ] } ] }, "ScalingInstructions": [ { "MaxCapacity": number, "MinCapacity": number, "ResourceId": "string", "ScalableDimension": "string", "ServiceNamespace": "string", "TargetTrackingConfigurations": [ { "CustomizedScalingMetricSpecification": { "Dimensions": [ { "Name": "string", "Value": "string" } ], "MetricName": "string", "Namespace": "string", "Statistic": "string", "Unit": "string" }, "DisableScaleIn": boolean, "EstimatedInstanceWarmup": number, "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "string", "ResourceLabel": "string" }, "ScaleInCooldown": number, "ScaleOutCooldown": number, "TargetValue": number } ] } ], "ScalingPlanName": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


A CloudFormation stack or set of tags. You can create one scaling plan per application source.

Type: ApplicationSource object

Required: Yes


The scaling instructions.

Type: Array of ScalingInstruction objects

Required: Yes


The name of the scaling plan. Names cannot contain vertical bars, colons, or forward slashes.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [\p{Print}&&[^|:/]]+

Required: Yes

Response Syntax

{ "ScalingPlanVersion": number }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.


The version of the scaling plan. This value is always 1.

Type: Long


For information about the errors that are common to all actions, see Common Errors.


Concurrent updates caused an exception, for example, if you request an update to a scaling plan that already has a pending update.

HTTP Status Code: 400


The service encountered an internal error.

HTTP Status Code: 400


Your account exceeded a limit. This exception is thrown when a per-account resource limit is exceeded.

HTTP Status Code: 400


An exception was thrown for a validation issue. Review the parameters provided.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: