AWS EC2 Connector

  • Latest Dynatrace
  • Reference
  • 14-min read

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.

Attach volume

Attaches an EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

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

Required AWS permission: ec2:AttachVolume.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
Device
string
The device name (for example, /dev/sdh or xvdh).
required
InstanceId
string
The ID of the instance.
required
VolumeId
string
The ID of the EBS volume.
required
DryRun
boolean
Checks whether you have the required permissions for the action without making the request and provides an error response.
optional

Output

Returns fields as described in AttachVolumeCommandOutput.

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.

Create volume

Creates an EBS volume that can be attached to an instance in the same Availability Zone.

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

Required AWS permission: ec2:CreateVolume.

Optional AWS permissions:

  • ec2:CreateTags

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
AvailabilityZone
string
The ID of the Availability Zone in which to create the volume.
required
ClientToken
string
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.
optional
DryRun
boolean
Checks whether you have the required permissions for the action without making the request and provides an error response.
optional
Encrypted
boolean
Indicates whether the volume should be encrypted.
optional
Iops
number
The number of I/O operations per second (IOPS).
optional
KmsKeyId
string
The identifier of the KMS key to use for Amazon EBS encryption.
optional
MultiAttachEnabled
boolean
Indicates whether to enable Amazon EBS Multi-Attach.
optional
OutpostArn
string
The Amazon Resource Name (ARN) of the Outpost on which to create the volume.
optional
Size
number
The size of the volume in GiBs.
optional
SnapshotId
string
The snapshot from which to create the volume.
optional
TagSpecifications
TagSpecification[]
The tags to apply to the volume during creation.
optional
Throughput
number
The throughput to provision for a volume with a maximum of 1,000 MiB/s.
optional
VolumeType
VolumeType
The volume type.
optional

Output

Returns fields as described in CreateVolumeCommandOutput.

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
NextToken
string
The token to use to retrieve the next page of results.
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
NextToken
string
The token returned from a previous paginated 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[]
The names of the security groups.
optional
MaxResults
number
The maximum number of items to return for this request.
optional
NextToken
string
The token returned from a previous paginated 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
NextToken
string
The token returned from a previous paginated request.
optional

Output

Returns fields as described in DescribeTagsCommandOutput.

Detach volume

Detaches an EBS volume from an instance.

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

Required AWS permission: ec2:DetachVolume.

Inputs

Field
Type
Description
Required
Region
string
The region to use.
required
VolumeId
string
The ID of the volume.
required
Device
string
The device name.
optional
DryRun
boolean
Checks whether you have the required permissions for the action without making the request and provides an error response.
optional
Force
boolean
Forces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally).
optional
InstanceId
string
The ID of the instance.
optional

Output

Returns fields as described in DetachVolumeCommandOutput.

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
Enable or disable termination protection for the instance.
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.

Related tags
Software Delivery