AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::AppRunner::AutoScalingConfiguration

CfnAutoScalingConfiguration

Specify an AWS App Runner Automatic Scaling configuration by using the `AWS::AppRunner::AutoScalingConfiguration` resource in an AWS CloudFormation template. The `AWS::AppRunner::AutoScalingConfiguration` resource is an AWS App Runner resource type that specifies an App Runner automatic scaling configuration. App Runner requires this resource to set non-default auto scaling settings for instances used to process the web requests. You can share an auto scaling configuration across multiple services. Create multiple revisions of a configuration by calling this action multiple times using the same `AutoScalingConfigurationName` . The call returns incremental `AutoScalingConfigurationRevision` values. When you create a service and configure an auto scaling configuration resource, the service uses the latest active revision of the auto scaling configuration by default. You can optionally configure the service to use a specific revision. Configure a higher `MinSize` to increase the spread of your App Runner service over more Availability Zones in the AWS Region . The tradeoff is a higher minimal cost. Configure a lower `MaxSize` to control your cost. The tradeoff is lower responsiveness during peak demand.

Import

import { CfnAutoScalingConfiguration } from 'aws-cdk-lib/aws-apprunner';

Or use the module namespace:

import * as apprunner from 'aws-cdk-lib/aws-apprunner';
// apprunner.CfnAutoScalingConfiguration

Properties

Configuration passed to the constructor as CfnAutoScalingConfigurationProps.

autoScalingConfigurationNameOptional
string

The customer-provided auto scaling configuration name. It can be used in multiple revisions of a configuration.

maxConcurrencyOptional
number

The maximum number of concurrent requests that an instance processes. If the number of concurrent requests exceeds this limit, App Runner scales the service up.

maxSizeOptional
number

The maximum number of instances that a service scales up to. At most `MaxSize` instances actively serve traffic for your service.

minSizeOptional
number

The minimum number of instances that App Runner provisions for a service. The service always has at least `MinSize` provisioned instances. Some of them actively serve traffic. The rest of them (provisioned and inactive instances) are a cost-effective compute capacity reserve and are ready to be quickly activated. You pay for memory usage of all the provisioned instances. You pay for CPU usage of only the active subset. App Runner temporarily doubles the number of provisioned instances during deployments, to maintain the same capacity for both old and new code.

tagsOptional
CfnTag[]

A list of metadata items that you can associate with your auto scaling configuration resource. A tag is a key-value pair.

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-apprunner
CFN TypeAWS::AppRunner::AutoScalingConfiguration
Properties5

External Links