AWS EC2 Connector

Latest Dynatrace

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

Create Snapshot

Creates a snapshot of an EBS volume and stores it in Amazon S3.

For more information, see the official documentation of Create Snapshot.

Required AWS permission: ec2:CreateSnapshot.

Optional AWS permissions:

  • ec2:CreateTags

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
VolumeId
string
The ID of the Amazon EBS volume.
required
Description
string
A description for the snapshot.
optional
DryRun
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response.
optional
OutpostArn
string
The Amazon Resource Name (ARN) of the Outpost on which to create a local snapshot.
optional
TagSpecifications
TagSpecification[]
The tags to apply to the snapshot during creation.
optional

Output

Returns fields as described in CreateSnapshotCommandOutput.

Create Tags

Adds or overwrites only the specified tags for the specified Amazon EC2 resource or resources.

For more information, see the official documentation of Create Tags.

Required AWS permission: ec2:CreateTags.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Resources
string[]
The IDs of the resources, separated by spaces.
required
Tags
Tag[]
The tags.
required

Output

Returns fields as described in CreateTagsCommandOutput.

Delete Tags

Deletes the specified set of tags from the specified set of resources.

For more information, see the official documentation of Delete Tags.

Required AWS permission: ec2:DeleteTags.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Resources
string[]
The IDs of the resources, separated by spaces.
required
Tags
Tag[]
The tags to delete.
optional

Output

Returns fields as described in DeleteTagsCommandOutput.

Describe Availability Zones

Describes the Availability Zones, Local Zones, and Wavelength Zones that are available to you.

For more information, see the official documentation of Describe Availability Zones.

Required AWS permission: ec2:DescribeAvailabilityZones.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AllAvailabilityZones
boolean
Include all Availability Zones, Local Zones, and Wavelength Zones regardless of your opt-in status.
optional
Filters
Filter[]
The filters.
optional
ZoneIds
string[]
The IDs of the Availability Zones, Local Zones, and Wavelength Zones.
optional
ZoneNames
string[]
The names of the Availability Zones, Local Zones, and Wavelength Zones.
optional

Output

Returns fields as described in DescribeAvailabilityZonesCommandOutput.

Describe Hosts

Describes the specified Dedicated Hosts or all your Dedicated Hosts.

For more information, see the official documentation of Describe Hosts.

Required AWS permission: ec2:DescribeHosts.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filter
Filter[]
The filters.
optional
HostIds
string[]
The IDs of the Dedicated Hosts.
optional
MaxResults
number
The maximum number of results to return for the request in a single page.
optional

Output

Returns fields as described in DescribeHostsCommandOutput.

Describe Instances

Describes the specified instances or all instances.

For more information, see the official documentation of Describe Instances.

Required AWS permission: ec2:DescribeInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filters
Filter[]
The filters.
optional
InstanceIds
string[]
The instance IDs.
optional
MaxResults
number
The maximum number of items to return for this request.
optional

Output

Returns fields as described in DescribeInstancesCommandOutput.

Describe Security Groups

Describes the specified security groups or all of your security groups.

For more information, see the official documentation of Describe Security Groups.

Required AWS permission: ec2:DescribeSecurityGroups.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filters
Filter[]
The filters.
optional
GroupIds
string[]
The IDs of the security groups.
optional
GroupNames
string[]
[Default VPC] The names of the security groups.
optional
MaxResults
number
The maximum number of items to return for this request.
optional

Output

Returns fields as described in DescribeSecurityGroupsCommandOutput.

Describe Tags

Describes the specified tags for your EC2 resources.

For more information, see the official documentation of Describe Tags.

Required AWS permission: ec2:DescribeTags.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Filters
Filter[]
The filters.
optional
MaxResults
number
The maximum number of items to return for this request.
optional

Output

Returns fields as described in DescribeTagsCommandOutput.

Modify Instance Attribute

Modifies the specified attribute of the specified instance.

For more information, see the official documentation of Modify Instance Attribute.

Required AWS permission: ec2:ModifyInstanceAttribute.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceId
string
The ID of the instance.
required
Attribute
InstanceAttributeName
The name of the attribute to modify.
optional
BlockDeviceMappings
InstanceBlockDeviceMappingSpecification[]
Modifies the DeleteOnTermination attribute for volumes that are currently attached.
optional
DisableApiStop
AttributeBooleanValue
Indicates whether an instance is enabled for stop protection.
optional
DisableApiTermination
AttributeBooleanValue
If the value is true, you can't terminate the instance using the Amazon EC2 console, CLI, or API; otherwise, you can.
optional
DryRun
boolean
Checks whether you have the required permissions for the operation, without actually making the request, and provides an error response.
optional
EbsOptimized
AttributeBooleanValue
Specifies whether the instance is optimized for Amazon EBS I/O.
optional
EnaSupport
AttributeBooleanValue
Set to true to enable enhanced networking with ENA for the instance.
optional
Groups
string[]
Replaces the security groups of the instance with the specified security groups.
optional
InstanceInitiatedShutdownBehavior
AttributeValue
Specifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).
optional
InstanceType
AttributeValue
Changes the instance type to the specified value.
optional
Kernel
AttributeValue
Changes the instance's kernel to the specified value.
optional
Ramdisk
AttributeValue
Changes the instance's RAM disk to the specified value.
optional
SourceDestCheck
AttributeBooleanValue
Enable or disable source/destination checks, which ensure that the instance is either the source or the destination of any traffic that it receives.
optional
SriovNetSupport
AttributeValue
Set to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the instance.
optional
Value
string
A new value for the attribute.
optional

Output

Returns fields as described in ModifyInstanceAttributeCommandOutput.

Modify Snapshot Attribute

Adds or removes permission settings for the specified snapshot.

For more information, see the official documentation of Modify Snapshot Attribute.

Required AWS permission: ec2:ModifySnapshotAttribute.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
SnapshotId
string
The ID of the snapshot.
required
Attribute
SnapshotAttributeName
The snapshot attribute to modify.
optional
CreateVolumePermission
CreateVolumePermissionModifications
A JSON representation of the snapshot attribute modification.
optional
DryRun
boolean
Checks whether you have the required permissions for the action, without actually making the request, and provides an error response.
optional
GroupNames
string[]
The group to modify for the snapshot.
optional
OperationType
OperationType
The type of operation to perform to the attribute.
optional
UserIds
string[]
The account ID to modify for the snapshot.
optional

Output

Returns fields as described in ModifySnapshotAttributeCommandOutput.

Reboot Instances

Requests a reboot of the specified instances.

For more information, see the official documentation of Reboot Instances.

Required AWS permission: ec2:RebootInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceIds
string[]
The instance IDs.
required

Output

Returns fields as described in RebootInstancesCommandOutput.

Run Instances

Launches the specified number of instances using an AMI for which you have permissions.

For more information, see the official documentation of Run Instances.

Required AWS permission: ec2:RunInstances.

Optional AWS permissions:

  • ec2:CreateTags
  • iam:PassRole
  • ssm:GetParameters

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
MaxCount
number
The maximum number of instances to launch.
required
MinCount
number
The minimum number of instances to launch.
required
LaunchTemplate
LaunchTemplateSpecification
The launch template.
optional

Output

Returns fields as described in RunInstancesCommandOutput.

Start Instances

Starts an Amazon EBS-backed instance that you've previously stopped.

For more information, see the official documentation of Start Instances.

Required AWS permission: ec2:StartInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceIds
string[]
The IDs of the instances.
required

Output

Returns fields as described in StartInstancesCommandOutput.

Stop Instances

Stops an Amazon EBS-backed instance.

For more information, see the official documentation of Stop Instances.

Required AWS permission: ec2:StopInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceIds
string[]
The IDs of the instances.
required

Output

Returns fields as described in StopInstancesCommandOutput.

Terminate Instances

Shuts down the specified instances.

For more information, see the official documentation of Terminate Instances.

Required AWS permission: ec2:TerminateInstances.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
InstanceIds
string[]
The IDs of the instances.
required

Output

Returns fields as described in TerminateInstancesCommandOutput.