Skip to content

RosScalingRule

This class is a base encapsulation around the ROS resource type ALIYUN::ESS::ScalingRule, which is used to create a scaling rule.

Initializers

import ros_cdk_ess
ros_cdk_ess.RosScalingRule(
  scope: Construct,
  id: str,
  scaling_group_id: typing.Union[str, IResolvable],
  adjustment_type: typing.Union[str, IResolvable] = None,
  adjustment_value: typing.Union[typing.Union[int, float], IResolvable] = None,
  cooldown: typing.Union[typing.Union[int, float], IResolvable] = None,
  disable_scale_in: typing.Union[bool, IResolvable] = None,
  estimated_instance_warmup: typing.Union[typing.Union[int, float], IResolvable] = None,
  initial_max_size: typing.Union[typing.Union[int, float], IResolvable] = None,
  metric_name: typing.Union[str, IResolvable] = None,
  min_adjustment_magnitude: typing.Union[typing.Union[int, float], IResolvable] = None,
  predictive_scaling_mode: typing.Union[str, IResolvable] = None,
  predictive_task_buffer_time: typing.Union[typing.Union[int, float], IResolvable] = None,
  predictive_value_behavior: typing.Union[str, IResolvable] = None,
  predictive_value_buffer: typing.Union[typing.Union[int, float], IResolvable] = None,
  scale_in_evaluation_count: typing.Union[typing.Union[int, float], IResolvable] = None,
  scale_out_evaluation_count: typing.Union[typing.Union[int, float], IResolvable] = None,
  scaling_rule_name: typing.Union[str, IResolvable] = None,
  scaling_rule_type: typing.Union[str, IResolvable] = None,
  step_adjustment: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, StepAdjustmentProperty]]] = None,
  target_value: typing.Union[typing.Union[int, float], IResolvable] = None,
  enable_resource_property_constraint: bool
)
Name Type Description
scope ros_cdk_core.Construct - scope in which this resource is defined.
id str - scoped id of the resource.
scaling_group_id typing.Union[str, ros_cdk_core.IResolvable] No description.
adjustment_type typing.Union[str, ros_cdk_core.IResolvable] No description.
adjustment_value typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
cooldown typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
disable_scale_in typing.Union[bool, ros_cdk_core.IResolvable] No description.
estimated_instance_warmup typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
initial_max_size typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
metric_name typing.Union[str, ros_cdk_core.IResolvable] No description.
min_adjustment_magnitude typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
predictive_scaling_mode typing.Union[str, ros_cdk_core.IResolvable] No description.
predictive_task_buffer_time typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
predictive_value_behavior typing.Union[str, ros_cdk_core.IResolvable] No description.
predictive_value_buffer typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scale_in_evaluation_count typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scale_out_evaluation_count typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scaling_rule_name typing.Union[str, ros_cdk_core.IResolvable] No description.
scaling_rule_type typing.Union[str, ros_cdk_core.IResolvable] No description.
step_adjustment typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, StepAdjustmentProperty]]] No description.
target_value typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
enable_resource_property_constraint bool No description.

scopeRequired

  • Type: ros_cdk_core.Construct

scope in which this resource is defined.


idRequired

  • Type: str

scoped id of the resource.


scaling_group_idRequired

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

adjustment_typeOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

adjustment_valueOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

cooldownOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

disable_scale_inOptional

  • Type: typing.Union[bool, ros_cdk_core.IResolvable]

estimated_instance_warmupOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

initial_max_sizeOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

metric_nameOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

min_adjustment_magnitudeOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

predictive_scaling_modeOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

predictive_task_buffer_timeOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

predictive_value_behaviorOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

predictive_value_bufferOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scale_in_evaluation_countOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scale_out_evaluation_countOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scaling_rule_nameOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

scaling_rule_typeOptional

  • Type: typing.Union[str, ros_cdk_core.IResolvable]

step_adjustmentOptional

  • Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, StepAdjustmentProperty]]]

target_valueOptional

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

enable_resource_property_constraintRequired

  • Type: bool

Methods

Name Description
to_string Returns a string representation of this construct.
synthesize Allows this construct to emit artifacts into the cloud assembly during synthesis.
override_logical_id Overrides the auto-generated logical ID with a specific ID.
add_condition No description.
add_count No description.
add_deletion_override Syntactic sugar for addOverride(path, undefined).
add_depends_on Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.
add_desc No description.
add_meta_data No description.
add_override Adds an override to the synthesized ROS resource.
add_property_deletion_override Adds an override that deletes the value of a property from the resource definition.
add_property_override Adds an override to a resource property.
add_ros_dependency No description.
apply_removal_policy Sets the deletion policy of the resource based on the removal policy specified.
get_att Returns a token for an runtime attribute of this resource.

to_string

def to_string() -> str

Returns a string representation of this construct.

synthesize

def synthesize(
  session: ISynthesisSession
) -> None

Allows this construct to emit artifacts into the cloud assembly during synthesis.

This method is usually implemented by framework-level constructs such as Stack and Asset as they participate in synthesizing the cloud assembly.

sessionRequired

  • Type: ros_cdk_core.ISynthesisSession

The synthesis session.


override_logical_id

def override_logical_id(
  new_logical_id: str
) -> None

Overrides the auto-generated logical ID with a specific ID.

new_logical_idRequired

  • Type: str

The new logical ID to use for this stack element.


add_condition

def add_condition(
  con: RosCondition
) -> None

conRequired

  • Type: ros_cdk_core.RosCondition

add_count

def add_count(
  count: typing.Union[typing.Union[int, float], IResolvable]
) -> None

countRequired

  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

add_deletion_override

def add_deletion_override(
  path: str
) -> None

Syntactic sugar for addOverride(path, undefined).

pathRequired

  • Type: str

The path of the value to delete.


add_depends_on

def add_depends_on(
  target: RosResource
) -> None

Indicates that this resource depends on another resource and cannot be provisioned unless the other resource has been successfully provisioned.

This can be used for resources across stacks (or nested stack) boundaries and the dependency will automatically be transferred to the relevant scope.

targetRequired

  • Type: ros_cdk_core.RosResource

add_desc

def add_desc(
  desc: str
) -> None

descRequired

  • Type: str

add_meta_data

def add_meta_data(
  key: str,
  value: typing.Any
) -> None

keyRequired

  • Type: str

valueRequired

  • Type: typing.Any

add_override

def add_override(
  path: str,
  value: typing.Any
) -> None

Adds an override to the synthesized ROS resource.

To add a property override, either use addPropertyOverride or prefix path with "Properties." (i.e. Properties.TopicName).

If the override is nested, separate each nested level using a dot (.) in the path parameter. If there is an array as part of the nesting, specify the index in the path.

For example,

addOverride('Properties.GlobalSecondaryIndexes.0.Projection.NonKeyAttributes', ['myattribute'])
addOverride('Properties.GlobalSecondaryIndexes.1.ProjectionType', 'INCLUDE')

would add the overrides

"Properties": {
   "GlobalSecondaryIndexes": [
     {
       "Projection": {
         "NonKeyAttributes": [ "myattribute" ]
         ...
       }
       ...
     },
     {
       "ProjectionType": "INCLUDE"
       ...
     },
   ]
   ...
}

pathRequired

  • Type: str

The path of the property, you can use dot notation to override values in complex types.

Any intermdediate keys will be created as needed.


valueRequired

  • Type: typing.Any

The value.

Could be primitive or complex.


add_property_deletion_override

def add_property_deletion_override(
  property_path: str
) -> None

Adds an override that deletes the value of a property from the resource definition.

property_pathRequired

  • Type: str

The path to the property.


add_property_override

def add_property_override(
  property_path: str,
  value: typing.Any
) -> None

Adds an override to a resource property.

Syntactic sugar for addOverride("Properties.<...>", value).

property_pathRequired

  • Type: str

The path of the property.


valueRequired

  • Type: typing.Any

The value.


add_ros_dependency

def add_ros_dependency(
  target: str
) -> None

targetRequired

  • Type: str

apply_removal_policy

def apply_removal_policy(
  policy: RemovalPolicy = None,
  apply_to_update_replace_policy: bool = None,
  default_policy: RemovalPolicy = None
) -> None

Sets the deletion policy of the resource based on the removal policy specified.

policyOptional

  • Type: ros_cdk_core.RemovalPolicy

apply_to_update_replace_policyOptional

  • Type: bool

default_policyOptional

  • Type: ros_cdk_core.RemovalPolicy

get_att

def get_att(
  attribute_name: str
) -> Reference

Returns a token for an runtime attribute of this resource.

Ideally, use generated attribute accessors (e.g. resource.arn), but this can be used for future compatibility in case there is no generated attribute.

attribute_nameRequired

  • Type: str

The name of the attribute.


Static Functions

Name Description
is_construct Return whether the given object is a Construct.
is_ros_element Returns true if a construct is a stack element (i.e. part of the synthesized template).
is_ros_resource Check whether the given construct is a RosResource.

is_construct

import ros_cdk_ess
ros_cdk_ess.RosScalingRule.is_construct(
  x: typing.Any
)

Return whether the given object is a Construct.

xRequired

  • Type: typing.Any

is_ros_element

import ros_cdk_ess
ros_cdk_ess.RosScalingRule.is_ros_element(
  x: typing.Any
)

Returns true if a construct is a stack element (i.e. part of the synthesized template).

Uses duck-typing instead of instanceof to allow stack elements from different versions of this library to be included in the same stack.

xRequired

  • Type: typing.Any

is_ros_resource

import ros_cdk_ess
ros_cdk_ess.RosScalingRule.is_ros_resource(
  construct: IConstruct
)

Check whether the given construct is a RosResource.

constructRequired

  • Type: ros_cdk_core.IConstruct

Properties

Name Type Description
node ros_cdk_core.ConstructNode The construct tree node associated with this construct.
creation_stack typing.List[str] No description.
logical_id str The logical ID for this stack element.
stack ros_cdk_core.Stack The stack in which this element is defined.
ref str Return a string that will be resolved to a RosTemplate { Ref } for this element.
ros_options ros_cdk_core.IRosResourceOptions Options for this resource, such as condition, update policy etc.
ros_resource_type str ROS resource type.
attr_scaling_rule_ari ros_cdk_core.IResolvable No description.
attr_scaling_rule_id ros_cdk_core.IResolvable No description.
enable_resource_property_constraint bool No description.
scaling_group_id typing.Union[str, ros_cdk_core.IResolvable] No description.
adjustment_type typing.Union[str, ros_cdk_core.IResolvable] No description.
adjustment_value typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
cooldown typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
disable_scale_in typing.Union[bool, ros_cdk_core.IResolvable] No description.
estimated_instance_warmup typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
initial_max_size typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
metric_name typing.Union[str, ros_cdk_core.IResolvable] No description.
min_adjustment_magnitude typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
predictive_scaling_mode typing.Union[str, ros_cdk_core.IResolvable] No description.
predictive_task_buffer_time typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
predictive_value_behavior typing.Union[str, ros_cdk_core.IResolvable] No description.
predictive_value_buffer typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scale_in_evaluation_count typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scale_out_evaluation_count typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.
scaling_rule_name typing.Union[str, ros_cdk_core.IResolvable] No description.
scaling_rule_type typing.Union[str, ros_cdk_core.IResolvable] No description.
step_adjustment typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, StepAdjustmentProperty]]] No description.
target_value typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable] No description.

nodeRequired

node: ConstructNode
  • Type: ros_cdk_core.ConstructNode

The construct tree node associated with this construct.


creation_stackRequired

creation_stack: typing.List[str]
  • Type: typing.List[str]

logical_idRequired

logical_id: str
  • Type: str

The logical ID for this stack element.

The logical ID of the element is calculated from the path of the resource node in the construct tree.

To override this value, use overrideLogicalId(newLogicalId).


stackRequired

stack: Stack
  • Type: ros_cdk_core.Stack

The stack in which this element is defined.

RosElements must be defined within a stack scope (directly or indirectly).


refRequired

ref: str
  • Type: str

Return a string that will be resolved to a RosTemplate { Ref } for this element.

If, by any chance, the intrinsic reference of a resource is not a string, you could coerce it to an IResolvable through Lazy.any({ produce: resource.ref }).


ros_optionsRequired

ros_options: IRosResourceOptions
  • Type: ros_cdk_core.IRosResourceOptions

Options for this resource, such as condition, update policy etc.


ros_resource_typeRequired

ros_resource_type: str
  • Type: str

ROS resource type.


attr_scaling_rule_ariRequired

attr_scaling_rule_ari: IResolvable
  • Type: ros_cdk_core.IResolvable

attr_scaling_rule_idRequired

attr_scaling_rule_id: IResolvable
  • Type: ros_cdk_core.IResolvable

enable_resource_property_constraintRequired

enable_resource_property_constraint: bool
  • Type: bool

scaling_group_idRequired

scaling_group_id: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

adjustment_typeOptional

adjustment_type: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

adjustment_valueOptional

adjustment_value: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

cooldownOptional

cooldown: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

disable_scale_inOptional

disable_scale_in: typing.Union[bool, IResolvable]
  • Type: typing.Union[bool, ros_cdk_core.IResolvable]

estimated_instance_warmupOptional

estimated_instance_warmup: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

initial_max_sizeOptional

initial_max_size: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

metric_nameOptional

metric_name: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

min_adjustment_magnitudeOptional

min_adjustment_magnitude: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

predictive_scaling_modeOptional

predictive_scaling_mode: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

predictive_task_buffer_timeOptional

predictive_task_buffer_time: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

predictive_value_behaviorOptional

predictive_value_behavior: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

predictive_value_bufferOptional

predictive_value_buffer: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scale_in_evaluation_countOptional

scale_in_evaluation_count: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scale_out_evaluation_countOptional

scale_out_evaluation_count: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

scaling_rule_nameOptional

scaling_rule_name: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

scaling_rule_typeOptional

scaling_rule_type: typing.Union[str, IResolvable]
  • Type: typing.Union[str, ros_cdk_core.IResolvable]

step_adjustmentOptional

step_adjustment: typing.Union[IResolvable, typing.List[typing.Union[IResolvable, StepAdjustmentProperty]]]
  • Type: typing.Union[ros_cdk_core.IResolvable, typing.List[typing.Union[ros_cdk_core.IResolvable, StepAdjustmentProperty]]]

target_valueOptional

target_value: typing.Union[typing.Union[int, float], IResolvable]
  • Type: typing.Union[typing.Union[int, float], ros_cdk_core.IResolvable]

Constants

Name Type Description
ROS_RESOURCE_TYPE_NAME str The resource type name for this resource class.

ROS_RESOURCE_TYPE_NAMERequired

ROS_RESOURCE_TYPE_NAME: str
  • Type: str

The resource type name for this resource class.