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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
InstanceIdsstring[]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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamesstring[]The names of the Auto Scaling groups.optional
FiltersFilter[]One or more filters to limit the results based on specific tags.optional
MaxRecordsnumberThe maximum number of items to return with this call.optional
NextTokenstringThe 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
InstanceIdsstring[]The IDs of the instances.optional
MaxRecordsnumberThe maximum number of items to return with this call.optional
NextTokenstringThe 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
InstanceRefreshIdsstring[]One or more instance refresh IDs.optional
MaxRecordsnumberThe maximum number of items to return with this call.optional
NextTokenstringThe 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
ActivityIdsstring[]The activity IDs of the desired scaling activities.optional
AutoScalingGroupNamestringThe name of the Auto Scaling group.optional
MaxRecordsnumberThe maximum number of items to return with this call.optional
NextTokenstringThe 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
ShouldDecrementDesiredCapacitybooleanIndicates whether the Auto Scaling group decrements the desired capacity value by the number of instances detached.required
InstanceIdsstring[]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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
PolicyNamestringThe name or ARN of the policy.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.optional
BreachThresholdnumberThe breach threshold for the alarm.optional
HonorCooldownbooleanIndicates whether Amazon EC2 Auto Scaling waits for the cooldown period to complete before executing the policy.optional
MetricValuenumberThe 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
DesiredCapacitynumberThe desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.required
HonorCooldownbooleanIndicates 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
DesiredConfigurationDesiredConfigurationThe desired configuration.optional
PreferencesRefreshPreferencesSets 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

FieldTypeDescriptionRequired
RegionstringThe region to use.required
AutoScalingGroupNamestringThe name of the Auto Scaling group.required
DesiredCapacitynumberThe desired capacity is the initial capacity of the Auto Scaling group after this operation completes and the capacity it attempts to maintain.optional
MaxSizenumberThe maximum size of the Auto Scaling group.optional
MinSizenumberThe minimum size of the Auto Scaling group.optional

Output

Returns fields as described in UpdateAutoScalingGroupCommandOutput.

Related tags
Software Delivery