software.amazon.awscdk.services.applicationautoscaling

Interface ScalableTargetProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ScalableTargetProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:36.413Z")
 @Stability(value=Stable)
public interface ScalableTargetProps
extends software.amazon.jsii.JsiiSerializable

Properties for a scalable target.

Example:

 import software.amazon.awscdk.services.lambda.*;
 Code code;
 Function handler = Function.Builder.create(this, "MyFunction")
         .runtime(Runtime.PYTHON_3_7)
         .handler("index.handler")
         .code(code)
         .reservedConcurrentExecutions(2)
         .build();
 Version fnVer = handler.getCurrentVersion();
 ScalableTarget target = ScalableTarget.Builder.create(this, "ScalableTarget")
         .serviceNamespace(ServiceNamespace.LAMBDA)
         .maxCapacity(100)
         .minCapacity(10)
         .resourceId(String.format("function:%s:%s", handler.getFunctionName(), fnVer.getVersion()))
         .scalableDimension("lambda:function:ProvisionedConcurrency")
         .build();
 target.scaleToTrackMetric("PceTracking", BasicTargetTrackingScalingPolicyProps.builder()
         .targetValue(0.9)
         .predefinedMetric(PredefinedMetric.LAMBDA_PROVISIONED_CONCURRENCY_UTILIZATION)
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ScalableTargetProps.Builder A builder for ScalableTargetProps
static class	ScalableTargetProps.Jsii$Proxy An implementation for ScalableTargetProps

Method Summary

Modifier and Type	Method and Description
static ScalableTargetProps.Builder	builder()
Number	getMaxCapacity() The maximum value that Application Auto Scaling can use to scale a target during a scaling activity.
Number	getMinCapacity() The minimum value that Application Auto Scaling can use to scale a target during a scaling activity.
String	getResourceId() The resource identifier to associate with this scalable target.
default IRole	getRole() Role that allows Application Auto Scaling to modify your scalable target.
String	getScalableDimension() The scalable dimension that's associated with the scalable target.
ServiceNamespace	getServiceNamespace() The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getMaxCapacity

@Stability(value=Stable)
 @NotNull
Number getMaxCapacity()

The maximum value that Application Auto Scaling can use to scale a target during a scaling activity.

getMinCapacity

@Stability(value=Stable)
 @NotNull
Number getMinCapacity()

The minimum value that Application Auto Scaling can use to scale a target during a scaling activity.

getResourceId

@Stability(value=Stable)
 @NotNull
String getResourceId()

The resource identifier to associate with this scalable target.

This string consists of the resource type and unique identifier.

Example value: service/ecsStack-MyECSCluster-AB12CDE3F4GH/ecsStack-MyECSService-AB12CDE3F4GH

See Also:

https://docs.aws.amazon.com/autoscaling/application/APIReference/API_RegisterScalableTarget.html

getScalableDimension

@Stability(value=Stable)
 @NotNull
String getScalableDimension()

The scalable dimension that's associated with the scalable target.

Specify the service namespace, resource type, and scaling property.

Example value: ecs:service:DesiredCount

See Also:

https://docs.aws.amazon.com/autoscaling/application/APIReference/API_ScalingPolicy.html

getServiceNamespace

@Stability(value=Stable)
 @NotNull
ServiceNamespace getServiceNamespace()

The namespace of the AWS service that provides the resource or custom-resource for a resource provided by your own application or service.

For valid AWS service namespace values, see the RegisterScalableTarget action in the Application Auto Scaling API Reference.

See Also:

https://docs.aws.amazon.com/autoscaling/application/APIReference/API_RegisterScalableTarget.html

getRole

@Stability(value=Stable)
 @Nullable
default IRole getRole()

Role that allows Application Auto Scaling to modify your scalable target.

Default: A role is automatically created

builder

@Stability(value=Stable)
static ScalableTargetProps.Builder builder()

Returns:

a ScalableTargetProps.Builder of ScalableTargetProps