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
RegionstringThe region to use.required
DevicestringThe device name (for example, /dev/sdh or xvdh).required
InstanceIdstringThe ID of the instance.required
VolumeIdstringThe ID of the EBS volume.required
DryRunbooleanChecks 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
RegionstringThe region to use.required
VolumeIdstringThe ID of the Amazon EBS volume.required
DescriptionstringA description for the snapshot.optional
DryRunbooleanChecks whether you have the required permissions for the action, without actually making the request, and provides an error response.optional
OutpostArnstringThe Amazon Resource Name (ARN) of the Outpost on which to create a local snapshot.optional
TagSpecificationsTagSpecification[]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
RegionstringThe region to use.required
Resourcesstring[]The IDs of the resources, separated by spaces.required
TagsTag[]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
RegionstringThe region to use.required
AvailabilityZonestringThe ID of the Availability Zone in which to create the volume.required
ClientTokenstringUnique, case-sensitive identifier that you provide to ensure the idempotency of the request.optional
DryRunbooleanChecks whether you have the required permissions for the action without making the request and provides an error response.optional
EncryptedbooleanIndicates whether the volume should be encrypted.optional
IopsnumberThe number of I/O operations per second (IOPS).optional
KmsKeyIdstringThe identifier of the KMS key to use for Amazon EBS encryption.optional
MultiAttachEnabledbooleanIndicates whether to enable Amazon EBS Multi-Attach.optional
OutpostArnstringThe Amazon Resource Name (ARN) of the Outpost on which to create the volume.optional
SizenumberThe size of the volume in GiBs.optional
SnapshotIdstringThe snapshot from which to create the volume.optional
TagSpecificationsTagSpecification[]The tags to apply to the volume during creation.optional
ThroughputnumberThe throughput to provision for a volume with a maximum of 1,000 MiB/s.optional
VolumeTypeVolumeTypeThe 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
RegionstringThe region to use.required
Resourcesstring[]The IDs of the resources, separated by spaces.required
TagsTag[]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
RegionstringThe region to use.required
AllAvailabilityZonesbooleanInclude all Availability Zones, Local Zones, and Wavelength Zones regardless of your opt-in status.optional
FiltersFilter[]The filters.optional
ZoneIdsstring[]The IDs of the Availability Zones, Local Zones, and Wavelength Zones.optional
ZoneNamesstring[]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
RegionstringThe region to use.required
FilterFilter[]The filters.optional
HostIdsstring[]The IDs of the Dedicated Hosts.optional
MaxResultsnumberThe maximum number of results to return for the request in a single page.optional
NextTokenstringThe 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
RegionstringThe region to use.required
FiltersFilter[]The filters.optional
InstanceIdsstring[]The instance IDs.optional
MaxResultsnumberThe maximum number of items to return for this request.optional
NextTokenstringThe 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
RegionstringThe region to use.required
FiltersFilter[]The filters.optional
GroupIdsstring[]The IDs of the security groups.optional
GroupNamesstring[]The names of the security groups.optional
MaxResultsnumberThe maximum number of items to return for this request.optional
NextTokenstringThe 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
RegionstringThe region to use.required
FiltersFilter[]The filters.optional
MaxResultsnumberThe maximum number of items to return for this request.optional
NextTokenstringThe 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
RegionstringThe region to use.required
VolumeIdstringThe ID of the volume.required
DevicestringThe device name.optional
DryRunbooleanChecks whether you have the required permissions for the action without making the request and provides an error response.optional
ForcebooleanForces detachment if the previous detachment attempt did not occur cleanly (for example, logging into an instance, unmounting the volume, and detaching normally).optional
InstanceIdstringThe 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
RegionstringThe region to use.required
InstanceIdstringThe ID of the instance.required
AttributeInstanceAttributeNameThe name of the attribute to modify.optional
BlockDeviceMappingsInstanceBlockDeviceMappingSpecification[]Modifies the DeleteOnTermination attribute for volumes that are currently attached.optional
DisableApiStopAttributeBooleanValueIndicates whether an instance is enabled for stop protection.optional
DisableApiTerminationAttributeBooleanValueEnable or disable termination protection for the instance.optional
DryRunbooleanChecks whether you have the required permissions for the operation, without actually making the request, and provides an error response.optional
EbsOptimizedAttributeBooleanValueSpecifies whether the instance is optimized for Amazon EBS I/O.optional
EnaSupportAttributeBooleanValueSet to true to enable enhanced networking with ENA for the instance.optional
Groupsstring[]Replaces the security groups of the instance with the specified security groups.optional
InstanceInitiatedShutdownBehaviorAttributeValueSpecifies whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown).optional
InstanceTypeAttributeValueChanges the instance type to the specified value.optional
KernelAttributeValueChanges the instance's kernel to the specified value.optional
RamdiskAttributeValueChanges the instance's RAM disk to the specified value.optional
SourceDestCheckAttributeBooleanValueEnable or disable source/destination checks, which ensure that the instance is either the source or the destination of any traffic that it receives.optional
SriovNetSupportAttributeValueSet to simple to enable enhanced networking with the Intel 82599 Virtual Function interface for the instance.optional
ValuestringA 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
RegionstringThe region to use.required
SnapshotIdstringThe ID of the snapshot.required
AttributeSnapshotAttributeNameThe snapshot attribute to modify.optional
CreateVolumePermissionCreateVolumePermissionModificationsA JSON representation of the snapshot attribute modification.optional
DryRunbooleanChecks whether you have the required permissions for the action, without actually making the request, and provides an error response.optional
GroupNamesstring[]The group to modify for the snapshot.optional
OperationTypeOperationTypeThe type of operation to perform to the attribute.optional
UserIdsstring[]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
RegionstringThe region to use.required
InstanceIdsstring[]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
RegionstringThe region to use.required
MaxCountnumberThe maximum number of instances to launch.required
MinCountnumberThe minimum number of instances to launch.required
LaunchTemplateLaunchTemplateSpecificationThe 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
RegionstringThe region to use.required
InstanceIdsstring[]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
RegionstringThe region to use.required
InstanceIdsstring[]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
RegionstringThe region to use.required
InstanceIdsstring[]The IDs of the instances.required

Output

Returns fields as described in TerminateInstancesCommandOutput.

Related tags
Software Delivery