AWS EC2 Auto Scaling Connector

  • Latest Dynatrace
  • Reference
  • 7-min read

Review the required AWS permissions and condition keys of the AWS EC2 Auto Scaling Connector actions to ensure that you grant Dynatrace only a minimum set of permissions. For more information, see AWS documentation.

Attach instances

Attaches one or more EC2 instances to the specified Auto Scaling group.

For more information, see the official documentation of Attach instances.

Required AWS permission: autoscaling:AttachInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
InstanceIds
string[]
The IDs of the instances.
optional

Output

Returns fields as described in AttachInstancesCommandOutput.

Describe Auto Scaling groups

Gets information about the Auto Scaling groups in the account and Region.

For more information, see the official documentation of Describe Auto Scaling groups.

Required AWS permission: autoscaling:DescribeAutoScalingGroups.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupNames
string[]
The names of the Auto Scaling groups.
optional
Filters
Filter[]
One or more filters to limit the results based on specific tags.
optional
MaxRecords
number
The maximum number of items to return with this call.
optional
NextToken
string
The token for the next set of items to return.
optional

Output

Returns fields as described in DescribeAutoScalingGroupsCommandOutput.

Describe Auto Scaling instances

Gets information about the Auto Scaling instances in the account and Region.

For more information, see the official documentation of Describe Auto Scaling instances.

Required AWS permission: autoscaling:DescribeAutoScalingInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceIds
string[]
The IDs of the instances.
optional
MaxRecords
number
The maximum number of items to return with this call.
optional
NextToken
string
The token for the next set of items to return.
optional

Output

Returns fields as described in DescribeAutoScalingInstancesCommandOutput.

Describe instance refreshes

Gets information about the instance refreshes for the specified Auto Scaling group from the previous six weeks.

For more information, see the official documentation of Describe instance refreshes.

Required AWS permission: autoscaling:DescribeInstanceRefreshes.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
InstanceRefreshIds
string[]
One or more instance refresh IDs.
optional
MaxRecords
number
The maximum number of items to return with this call.
optional
NextToken
string
The token for the next set of items to return.
optional

Output

Returns fields as described in DescribeInstanceRefreshesCommandOutput.

Describe scaling activities

Gets information about the scaling activities in the account and Region.

For more information, see the official documentation of Describe scaling activities.

Required AWS permission: autoscaling:DescribeScalingActivities.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
ActivityIds
string[]
The activity IDs of the desired scaling activities.
optional
AutoScalingGroupName
string
The name of the Auto Scaling group.
optional
MaxRecords
number
The maximum number of items to return with this call.
optional
NextToken
string
The token for the next set of items to return.
optional

Output

Returns fields as described in DescribeScalingActivitiesCommandOutput.

Detach instances

Removes one or more instances from the specified Auto Scaling group.

For more information, see the official documentation of Detach instances.

Required AWS permission: autoscaling:DetachInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
ShouldDecrementDesiredCapacity
boolean
Indicates whether the Auto Scaling group decrements the desired capacity value by the number of instances detached.
required
InstanceIds
string[]
The IDs of the instances.
optional

Output

Returns fields as described in DetachInstancesCommandOutput.

Execute policy

Executes the specified policy.

For more information, see the official documentation of Execute policy.

Required AWS permission: autoscaling:ExecutePolicy.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
PolicyName
string
The name or ARN of the policy.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
optional
BreachThreshold
number
The breach threshold for the alarm.
optional
HonorCooldown
boolean
Indicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before executing the policy.
optional
MetricValue
number
The metric value to compare to BreachThreshold.
optional

Output

Returns fields as described in ExecutePolicyCommandOutput.

Set desired capacity

Sets the size of the specified Auto Scaling group.

For more information, see the official documentation of Set desired capacity.

Required AWS permission: autoscaling:SetDesiredCapacity.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
DesiredCapacity
number
The desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.
required
HonorCooldown
boolean
Indicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before initiating a scaling activity to set your Auto Scaling group to its new capacity.
optional

Output

Returns fields as described in SetDesiredCapacityCommandOutput.

Start instance refresh

Starts an instance refresh.

For more information, see the official documentation of Start instance refresh.

Required AWS permission: autoscaling:StartInstanceRefresh.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
DesiredConfiguration
DesiredConfiguration
The desired configuration.
optional
Preferences
RefreshPreferences
Sets your preferences for the instance refresh so that it performs as expected when you start it.
optional

Output

Returns fields as described in StartInstanceRefreshCommandOutput.

Update Auto Scaling group

We strongly recommend that all Auto Scaling groups use launch templates to ensure full functionality for Amazon EC2 Auto Scaling and Amazon EC2.

For more information, see the official documentation of Update Auto Scaling group.

Required AWS permission: autoscaling:UpdateAutoScalingGroup.

Optional AWS permissions:

  • iam:PassRole

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AutoScalingGroupName
string
The name of the Auto Scaling group.
required
DesiredCapacity
number
The desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.
optional
MaxSize
number
The maximum size of the Auto Scaling group.
optional
MinSize
number
The minimum size of the Auto Scaling group.
optional

Output

Returns fields as described in UpdateAutoScalingGroupCommandOutput.

Related tags
Software Delivery