Module for the Amazon EC2 adapter

Each command supported by the application adapter has a corresponding process in the adapter module. Top-level processes perform high-level functions and call specialized processes in subdirectories. Each subdirectory contains process directories that correspond to the operation type for that command.

Top-level processes

The top-level processes perform high-level functions and call specialized processes in the subdirectories of the v1.0 directory.

The top-level processes in the Project Explorer window execute the following version-specific Amazon EC2 processes:

Create Items
Delete Items
Find Items
Perform Operations
Update Items

The following table describes the elements for the top-level processes:

Unknown macro: {multi-excerpt}

Elements for the top-level processes

Element	Definition	Required
`<adapter name>`	Specifies the name of the adapter	No
`<version>`	Specifies the current supported version, v1.0	Yes
`<wsdl location>`	Specifies the target WSDL URL for Amazon EC2 The value of `<wsdl location>` specified in the adapter request overrides the WSDL URL specified in the adapter configuration.	No
`<endpoint address>`	Specifies the relevant Amazon Web Service endpoint for performing operations on Amazon EC2 instances across different regions The value of `<endpoint address>` specified in the adapter request overrides the value specified in the adapter configuration.	No
`<signature properties>`	Specifies the mode for signing the adapter request The value of `<signature properties>` specified in the adapter request, overrides the value specified in the adapter configuration.	No
`<item type>`	Specifies the relevant item type for the process to be executed For more information, see mapping.	Yes
`<items>`	Contains the `<items>` XML used to perform an operation in Amazon EC2	Yes

Setup_Validation directory

The processes in the Setup_Validation directory contain sample values for the request elements.

You can change these sample values quickly to reflect the values in your environment. A process is provided to test each supported method of executing operations in Amazon EC2.

Utilities directory

The Utilities directory contains helper and constructor processes that create the XML inputs used in functional processes.

The functional processes require complex XML inputs. You can generate these complex XML inputs using the constructor processes in the Utilities directory.

v1.0 directory

The v1.0 directory contains functional processes specific to Amazon EC2. A process is available for each supported operation. Processes are grouped in subdirectories based on the type of the operation.

The following table shows the mapping between processes and operation names.

Mapping between processes and operation names

Process name	Operation name
Amazon Machine Image operations
Create Image	`create-image`
Describe Images	`describe-images`
Register Image	`register-image`
Deregister Image	`deregister-image`
Describe Image Attribute	`describe-image-attribute`
Modify Image Attribute	`modify-image-attribute`
Reset Image Attribute	`reset-image-attribute`
Instance operations
Start Instances	`start-instances`
Run Instances	`run-instances`
Stop Instances	`stop-instance`
Reboot Instances	`reboot-instances`
Terminate Instances	`terminate-instances`
Describe Instances	`describe-instances`
Describe Instance Attributes	`describe-instance-attribute`
Modify Instance Attribute	`modify-instance-attribute`
Reset Instance Attribute	`reset-instance-attribute`
Key-pair operations
Create Key Pair	`create-key-pair`
Describe Key Pairs	`describe-key-pairs`
Delete Key Pair	`delete-key-pair`
Monitoring operations
Monitor Instances	`monitor-instances`
Unmonitor Instances	`unmonitor-instances`
Security Group operations
Create Security Group	`create-security-group`
Authorize Security Group Ingress	`authorize-security-group-ingress`
Describe Security Groups	`describe-security-groups`
Revoke Security Group Ingress	`revoke-security-group-ingress`
Delete Security Group	`delete-security-group`
Utility operations
Get Console Output	`get-console-output`
Windows operations
Get Password Data	`get-password-data`
Describe Bundle Tasks	`describe-bundle-tasks`
Cancel Bundle Tasks	`cancel-bundle-task`
Bundle Instance	`bundle-instance`
Regions and Availability Zones operations
Describe Regions	`describe-regions`
Describe Availability Zones	`describe-availability-zones`
Elastic Block Store (EBS) operations
Create Volume	`create-volume`
Describe Volumes	`describe-volumes`
Delete Volume	`delete-volume`
Attach Volume	`attach-volume`
Detach Volume	`detach-volume`
Create Snapshot	`create-snapshot`
Describe Snapshots	`describe-snapshots`
Delete Snapshot	`delete-snapshot`
Describe Snapshot Attribute	`describe-snapshot-attribute`
Modify Snapshot Attribute	`modify-snapshot-attribute`
Reset Snapshot Attribute	`reset-snapshot-attribute`
Elastic IP Address operations
Allocate Address	`allocate-address`
Associate Address	`associate-address`
Disassociate Address	`disassociate-address`
Describe Addresses	`describe-addresses`
Release Address	`release-address`
Tag operations
Create Tags	`create-tags`
Delete Tags	`delete-tags`
Describe Tags	`describe-tags`
VPC operations
Create VPC	`create-vpc`
Delete VPC	`delete-vpc`
Describe VPCs	`describe-vpcs`
Subnet operations
Create Subnet	`create-subnet`
Delete Subnet	`delete-subnet`
Describe Subnets	`describe-subnets`

Adapter_Actions directory

The Adapter_Actions directory contains all the functional processes that are available in the v1.0 directory, with simplified input values.

The common inputs for these processes are adapter name, wsdl-location, and endpoint-address. The functional processes in the Adapter_Actions directory internally invoke the relevant constructor processes in the Utilities directory.