euca2ools man page

euca2ools — eucalyptus command line client tools


The euca2ools suite is a set of command line tools that interact with “Amazon Web Services” (AWS), Eucalyptus, and other AWS-compatible clouds using the REST- and query-based APIs for numerous web services.

The URL for each web service can be set with a SERVICE-url region option, where SERVICE is the name of the service, in euca2ools.ini(5) configuration files and then chosen with the --region command line option or the EUCA_DEFAULT_REGION or AWS_DEFAULT_REGION environment variables. Alternatively, the URL can be set at the command line or with an environment variable that is specific to the service. Environment variables take precedence over configuration file data.

euca2ools are designed to make it as easy as possible to work with multiple AWS-compatible clouds from the command line using euca2ools.ini(5) configuration files, command line options, and shortcuts.

List of Web Services

Name Version Environment variable Commands
autoscaling 2011-01-01 AWS_AUTO_SCALING_URL euscale-*
bootstrap EUCA_BOOTSTRAP_URL euca-bundle-image(1), euca-bundle-and-upload-image(1), euca-install-image(1), euimage-install-pack(1)
cloudformation 2010-05-15 AWS_CLOUDFORMATION_URL euform-*
ec2 2015-10-01 EC2_URL euca-*
elasticloadbalancing 2012-06-01 AWS_ELB_URL eulb-*
iam 2010-05-08 AWS_IAM_URL euare-*
monitoring 2010-08-01 AWS_CLOUDWATCH_URL euwatch-*
s3 2006-03-01 S3_URL euca-bundle-and-upload-image(1), euca-download-and-unbundle(1), euca-download-bundle(1), euca-install-image(1), euca-upload-bundle(1), euimage-install-pack(1)
sts 2011-06-15 TOKENS_URL euare-assumerole(1)


The “bootstrap” service, also known as the “Empyrean” service, is specific to eucalyptus. Commands that bundle images can optionally use it to obtain the cloud's signing certificate automatically, provided the cloud runs eucalyptus 4.2 or later.

See Also


Referenced By

euca2ools.ini(5), euwatch-put-data(1).