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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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

FieldTypeDescriptionRequired

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