10.5. AWS-EC2
EC2 Component
Available as of Camel 2.16
The EC2 component supports create, run, start, stop and terminate AWS EC2 instances.
Note
You must have a valid Amazon Web Services developer account, and be signed up to use Amazon EC2. More information are available at Amazon EC2.
URI Format
aws-ec2://label[?options]
You can append query options to the URI in the following format, ?options=value&option2=value&...
URI Options
|
Name
|
Default Value
|
Context
|
Description
|
|---|---|---|---|
|
amazonEc2Client
|
null
|
Producer
|
Reference to a com.amazonaws.services.ec2.AmazonEC2Client in the Registry.
|
|
accessKey
|
null
|
Producer
|
Amazon AWS Access Key
|
|
secretKey
|
null
|
Producer
|
Amazon AWS Secret Key
|
|
amazonEc2Endpoint
|
null
|
Producer
|
The region with which the AWS-EC2 client wants to work with.
|
|
operation
|
null
|
Producer
|
Valid values are createAndRunInstances, startInstances, stopInstances, terminateInstances, describeInstances, describeInstancesStatus, rebootInstances, monitorInstances and unmonitorInstances
|
|
proxyHost
|
null
|
Producer
|
Camel 2.16: Specify a proxy host to be used inside the client definition.
|
|
proxyPort
|
null
|
Producer
|
Camel 2.16: Specify a proxy port to be used inside the client definition.
|
Note
You have to provide the amazonEc2Client in the Registry or your accessKey and secretKey to access the Amazon EC2 service.
Message headers evaluated by the EC2 producer
|
Header
|
Type
|
Description
|
|---|---|---|
CamelAwsEC2ImageId
|
String
|
An image ID of the AWS marketplace
|
CamelAwsEC2InstanceType
|
com.amazonaws.services.ec2.model.InstanceType
|
The instance type we want to create and run
|
CamelAwsEC2Operation
|
String
|
The operation we want to perform
|
CamelAwsEC2InstanceMinCount
|
Int
|
The mininum number of instances we want to run.
|
CamelAwsEC2InstanceMaxCount
|
Int
|
The maximum number of instances we want to run.
|
CamelAwsEC2InstanceMonitoring
|
Boolean
|
Define if we want the running instances to be monitored
|
CamelAwsEC2InstanceEbsOptimized
|
Boolean
|
Define if the creating instance is optimized for EBS I/O.
|
CamelAwsEC2InstanceSecurityGroups
|
Collection
|
The security groups to associate to the instances
|
CamelAwsEC2InstancesIds
|
Collection
|
A collection of instances IDS to execute start, stop, describe and terminate operations on.
|
Dependencies
Maven users will need to add the following dependency to their pom.xml.
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-aws</artifactId>
<version>${camel-version}</version>
</dependency>
where
${camel-version} must be replaced by the actual version of Camel (2.16 or higher).
