interface PredictiveScalingPolicyConfigurationProperty

Language	Type name
.NET	`Amazon.CDK.Mixins.Preview.AWS.ApplicationAutoScaling.Mixins.CfnScalingPolicyPropsMixin.PredictiveScalingPolicyConfigurationProperty`
Go	`github.com/aws/aws-cdk-go/awscdkmixinspreview/v2/awsapplicationautoscaling/mixins#CfnScalingPolicyPropsMixin_PredictiveScalingPolicyConfigurationProperty`
Java	`software.amazon.awscdk.mixins.preview.services.applicationautoscaling.mixins.CfnScalingPolicyPropsMixin.PredictiveScalingPolicyConfigurationProperty`
Python	`aws_cdk.mixins_preview.aws_applicationautoscaling.mixins.CfnScalingPolicyPropsMixin.PredictiveScalingPolicyConfigurationProperty`
TypeScript	`@aws-cdk/mixins-preview` » `aws_applicationautoscaling` » `mixins` » `CfnScalingPolicyPropsMixin` » `PredictiveScalingPolicyConfigurationProperty`

Represents a predictive scaling policy configuration.

Predictive scaling is supported on Amazon ECS services.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { mixins as applicationautoscaling_mixins } from '@aws-cdk/mixins-preview/aws-applicationautoscaling';
const predictiveScalingPolicyConfigurationProperty: applicationautoscaling_mixins.CfnScalingPolicyPropsMixin.PredictiveScalingPolicyConfigurationProperty = {
  maxCapacityBreachBehavior: 'maxCapacityBreachBehavior',
  maxCapacityBuffer: 123,
  metricSpecifications: [{
    customizedCapacityMetricSpecification: {
      metricDataQueries: [{
        expression: 'expression',
        id: 'id',
        label: 'label',
        metricStat: {
          metric: {
            dimensions: [{
              name: 'name',
              value: 'value',
            }],
            metricName: 'metricName',
            namespace: 'namespace',
          },
          stat: 'stat',
          unit: 'unit',
        },
        returnData: false,
      }],
    },
    customizedLoadMetricSpecification: {
      metricDataQueries: [{
        expression: 'expression',
        id: 'id',
        label: 'label',
        metricStat: {
          metric: {
            dimensions: [{
              name: 'name',
              value: 'value',
            }],
            metricName: 'metricName',
            namespace: 'namespace',
          },
          stat: 'stat',
          unit: 'unit',
        },
        returnData: false,
      }],
    },
    customizedScalingMetricSpecification: {
      metricDataQueries: [{
        expression: 'expression',
        id: 'id',
        label: 'label',
        metricStat: {
          metric: {
            dimensions: [{
              name: 'name',
              value: 'value',
            }],
            metricName: 'metricName',
            namespace: 'namespace',
          },
          stat: 'stat',
          unit: 'unit',
        },
        returnData: false,
      }],
    },
    predefinedLoadMetricSpecification: {
      predefinedMetricType: 'predefinedMetricType',
      resourceLabel: 'resourceLabel',
    },
    predefinedMetricPairSpecification: {
      predefinedMetricType: 'predefinedMetricType',
      resourceLabel: 'resourceLabel',
    },
    predefinedScalingMetricSpecification: {
      predefinedMetricType: 'predefinedMetricType',
      resourceLabel: 'resourceLabel',
    },
    targetValue: 123,
  }],
  mode: 'mode',
  schedulingBufferTime: 123,
};

Properties

Name	Type	Description
maxCapacityBreachBehavior?	`string`	Defines the behavior that should be applied if the forecast capacity approaches or exceeds the maximum capacity.
maxCapacityBuffer?	`number`	The size of the capacity buffer to use when the forecast capacity is close to or exceeds the maximum capacity.
metricSpecifications?	`IResolvable` `\| (IResolvable` `\|` `PredictiveScalingMetricSpecificationProperty)[]`	This structure includes the metrics and target utilization to use for predictive scaling.
mode?	`string`	The predictive scaling mode.
schedulingBufferTime?	`number`	The amount of time, in seconds, that the start time can be advanced.

maxCapacityBreachBehavior?

Type: string (optional)

Defines the behavior that should be applied if the forecast capacity approaches or exceeds the maximum capacity.

Defaults to HonorMaxCapacity if not specified.

maxCapacityBuffer?

Type: number (optional)

The size of the capacity buffer to use when the forecast capacity is close to or exceeds the maximum capacity.

The value is specified as a percentage relative to the forecast capacity. For example, if the buffer is 10, this means a 10 percent buffer, such that if the forecast capacity is 50, and the maximum capacity is 40, then the effective maximum capacity is 55.

Required if the MaxCapacityBreachBehavior property is set to IncreaseMaxCapacity , and cannot be used otherwise.

metricSpecifications?

Type: IResolvable | (IResolvable | PredictiveScalingMetricSpecificationProperty)[] (optional)

This structure includes the metrics and target utilization to use for predictive scaling.

This is an array, but we currently only support a single metric specification. That is, you can specify a target value and a single metric pair, or a target value and one scaling metric and one load metric.

mode?

Type: string (optional)

The predictive scaling mode.

Defaults to ForecastOnly if not specified.

schedulingBufferTime?

Type: number (optional)

The amount of time, in seconds, that the start time can be advanced.

The value must be less than the forecast interval duration of 3600 seconds (60 minutes). Defaults to 300 seconds if not specified.

AWS CDK

2.233.0