Subversion-Projekte lars-tiefland.php_share

<?php

/*

 * Copyright 2010-2012 Amazon.com, Inc. or its affiliates. All Rights Reserved.

 *

 * Licensed under the Apache License, Version 2.0 (the "License").

 * You may not use this file except in compliance with the License.

 * A copy of the License is located at

 *

 *  http://aws.amazon.com/apache2.0

 *

 * or in the "license" file accompanying this file. This file is distributed

 * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either

 * express or implied. See the License for the specific language governing

 * permissions and limitations under the License.

 */

/**

 * Amazon Elastic Compute Cloud (Amazon EC2) is a web service that provides resizable compute

 * capacity in the cloud. It is designed to make web-scale computing easier for developers.

 *

 * Amazon EC2's simple web service interface allows you to obtain and configure capacity with

 * minimal friction. It provides you with complete control of your computing resources and lets

 * you run on Amazon's proven computing environment. Amazon EC2 reduces the time required to

 * obtain and boot new server instances to minutes, allowing you to quickly scale capacity, both

 * up and down, as your computing requirements change. Amazon EC2 changes the economics of

 * computing by allowing you to pay only for capacity that you actually use. Amazon EC2 provides

 * developers the tools to build failure resilient applications and isolate themselves from common

 * failure scenarios.

 *

 * Visit <a href="http://aws.amazon.com/ec2/">http://aws.amazon.com/ec2/</a> for more information.

 *

 * @version 2012.01.17

 * @license See the included NOTICE.md file for complete information.

 * @copyright See the included NOTICE.md file for complete information.

 * @link http://aws.amazon.com/ec2/ Amazon EC2

 * @link http://aws.amazon.com/ec2/documentation/ Amazon EC2 documentation

 */

class AmazonEC2 extends CFRuntime

{

	/*%******************************************************************************************%*/

	// CLASS CONSTANTS

	/**

	 * Specify the queue URL for the United States East (Northern Virginia) Region.

	 */

	const REGION_US_E1 = 'ec2.us-east-1.amazonaws.com';

	/**

	 * Specify the queue URL for the United States East (Northern Virginia) Region.

	 */

	const REGION_VIRGINIA = self::REGION_US_E1;

	/**

	 * Specify the queue URL for the United States West (Northern California) Region.

	 */

	const REGION_US_W1 = 'ec2.us-west-1.amazonaws.com';

	/**

	 * Specify the queue URL for the United States West (Northern California) Region.

	 */

	const REGION_CALIFORNIA = self::REGION_US_W1;

	/**

	 * Specify the queue URL for the United States West (Oregon) Region.

	 */

	const REGION_US_W2 = 'ec2.us-west-2.amazonaws.com';

	/**

	 * Specify the queue URL for the United States West (Oregon) Region.

	 */

	const REGION_OREGON = self::REGION_US_W2;

	/**

	 * Specify the queue URL for the Europe West (Ireland) Region.

	 */

	const REGION_EU_W1 = 'ec2.eu-west-1.amazonaws.com';

	/**

	 * Specify the queue URL for the Europe West (Ireland) Region.

	 */

	const REGION_IRELAND = self::REGION_EU_W1;

	/**

	 * Specify the queue URL for the Asia Pacific Southeast (Singapore) Region.

	 */

	const REGION_APAC_SE1 = 'ec2.ap-southeast-1.amazonaws.com';

	/**

	 * Specify the queue URL for the Asia Pacific Southeast (Singapore) Region.

	 */

	const REGION_SINGAPORE = self::REGION_APAC_SE1;

	/**

	 * Specify the queue URL for the Asia Pacific Northeast (Tokyo) Region.

	 */

	const REGION_APAC_NE1 = 'ec2.ap-northeast-1.amazonaws.com';

	/**

	 * Specify the queue URL for the Asia Pacific Northeast (Tokyo) Region.

	 */

	const REGION_TOKYO = self::REGION_APAC_NE1;

	/**

	 * Specify the queue URL for the United States GovCloud Region.

	 */

	const REGION_US_GOV1 = 'ec2.us-gov-west-1.amazonaws.com';

	/**

	 * Specify the queue URL for the South America (Sao Paulo) Region.

	 */

	const REGION_SA_E1 = 'ec2.sa-east-1.amazonaws.com';

	/**

	 * Specify the queue URL for the South America (Sao Paulo) Region.

	 */

	const REGION_SAO_PAULO = self::REGION_SA_E1;

	/**

	 * Default service endpoint.

	 */

	const DEFAULT_URL = self::REGION_US_E1;

	/*%******************************************************************************************%*/

	// CONSTRUCTOR

	/**

	 * Constructs a new instance of <AmazonEC2>.

	 *

	 * @param array $options (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>certificate_authority</code> - <code>boolean</code> - Optional - Determines which Cerificate Authority file to use. A value of boolean <code>false</code> will use the Certificate Authority file available on the system. A value of boolean <code>true</code> will use the Certificate Authority provided by the SDK. Passing a file system path to a Certificate Authority file (chmodded to <code>0755</code>) will use that. Leave this set to <code>false</code> if you're not sure.</li>

	 * 	<li><code>credentials</code> - <code>string</code> - Optional - The name of the credential set to use for authentication.</li>

	 * 	<li><code>default_cache_config</code> - <code>string</code> - Optional - This option allows a preferred storage type to be configured for long-term caching. This can be changed later using the <set_cache_config()> method. Valid values are: <code>apc</code>, <code>xcache</code>, or a file system path such as <code>./cache</code> or <code>/tmp/cache/</code>.</li>

	 * 	<li><code>key</code> - <code>string</code> - Optional - Your AWS key, or a session key. If blank, the default credential set will be used.</li>

	 * 	<li><code>secret</code> - <code>string</code> - Optional - Your AWS secret key, or a session secret key. If blank, the default credential set will be used.</li>

	 * 	<li><code>token</code> - <code>string</code> - Optional - An AWS session token.</li></ul>

	 * @return void

	 */

	public function __construct(array $options = array())

	{

		$this->api_version = '2011-11-01';

		$this->hostname = self::DEFAULT_URL;

		$this->auth_class = 'AuthV2Query';

		return parent::__construct($options);

	}

	/*%******************************************************************************************%*/

	// STATE CONSTANTS

	const STATE_PENDING = 0;

	const STATE_RUNNING = 16;

	const STATE_SHUTTING_DOWN = 32;

	const STATE_TERMINATED = 48;

	const STATE_STOPPING = 64;

	const STATE_STOPPED = 80;

	/*%******************************************************************************************%*/

	// INSTANCE CONSTANTS

	// Standard

	const INSTANCE_MICRO = 't1.micro';

	const INSTANCE_SMALL = 'm1.small';

	const INSTANCE_LARGE = 'm1.large';

	const INSTANCE_XLARGE = 'm1.xlarge';

	// High Memory

	const INSTANCE_HIGH_MEM_XLARGE = 'm2.xlarge';

	const INSTANCE_HIGH_MEM_2XLARGE = 'm2.2xlarge';

	const INSTANCE_HIGH_MEM_4XLARGE = 'm2.4xlarge';

	// High CPU

	const INSTANCE_HIGH_CPU_MEDIUM = 'c1.medium';

	const INSTANCE_HIGH_CPU_XLARGE = 'c1.xlarge';

	// Cluster

	const INSTANCE_CLUSTER_4XLARGE = 'cc1.4xlarge';

	const INSTANCE_CLUSTER_8XLARGE = 'cc2.8xlarge';

	const INSTANCE_CLUSTER_GPU_XLARGE = 'cg1.4xlarge';

	/*%******************************************************************************************%*/

	// SETTERS

	/**

	 * This allows you to explicitly sets the region for the service to use.

	 *

	 * @param string $region (Required) The region to explicitly set. Available options are <REGION_US_E1>, <REGION_US_W1>, <REGION_US_W2>, <REGION_EU_W1>, <REGION_APAC_SE1>, <REGION_APAC_NE1>, <REGION_US_GOV1>, <REGION_SA_E1>.

	 * @return $this A reference to the current instance.

	 */

	public function set_region($region)

	{

		// @codeCoverageIgnoreStart

		$this->set_hostname($region);

		return $this;

		// @codeCoverageIgnoreEnd

	}

	/*%******************************************************************************************%*/

	// SERVICE METHODS

	/**

	 * Activates a specific number of licenses for a 90-day period. Activations can be done against a

	 * specific license ID.

	 *

	 * @param string $license_id (Required) Specifies the ID for the specific license to activate against.

	 * @param integer $capacity (Required) Specifies the additional number of licenses to activate.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function activate_license($license_id, $capacity, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['LicenseId'] = $license_id;

		$opt['Capacity'] = $capacity;

		return $this->authenticate('ActivateLicense', $opt);

	}

	/**

	 * The AllocateAddress operation acquires an elastic IP address for use with your account.

	 *

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Domain</code> - <code>string</code> - Optional - Set to <code>vpc</code> to allocate the address to your VPC. By default, will allocate to EC2. [Allowed values: <code>vpc</code>, <code>standard</code>]</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function allocate_address($opt = null)

	{

		if (!$opt) $opt = array();

		return $this->authenticate('AllocateAddress', $opt);

	}

	/**

	 * The AssociateAddress operation associates an elastic IP address with an instance.

	 *

	 * If the IP address is currently assigned to another instance, the IP address is assigned to the

	 * new instance. This is an idempotent operation. If you enter it more than once, Amazon EC2 does

	 * not return an error.

	 *

	 * @param string $instance_id (Required) The instance to associate with the IP address.

	 * @param string $public_ip (Required) IP address that you are assigning to the instance.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>AllocationId</code> - <code>string</code> - Optional - The allocation ID that AWS returned when you allocated the elastic IP address for use with Amazon VPC.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function associate_address($instance_id, $public_ip, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['InstanceId'] = $instance_id;

		$opt['PublicIp'] = $public_ip;

		return $this->authenticate('AssociateAddress', $opt);

	}

	/**

	 * Associates a set of DHCP options (that you've previously created) with the specified VPC. Or,

	 * associates the default DHCP options with the VPC. The default set consists of the standard EC2

	 * host name, no domain name, no DNS server, no NTP server, and no NetBIOS server or node type.

	 * After you associate the options with the VPC, any existing instances and all new instances that

	 * you launch in that VPC use the options. For more information about the supported DHCP options

	 * and using them with Amazon VPC, go to Using DHCP Options in the Amazon Virtual Private Cloud

	 * Developer Guide.

	 *

	 * @param string $dhcp_options_id (Required) The ID of the DHCP options to associate with the VPC. Specify "default" to associate the default DHCP options with the VPC.

	 * @param string $vpc_id (Required) The ID of the VPC to associate the DHCP options with.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function associate_dhcp_options($dhcp_options_id, $vpc_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['DhcpOptionsId'] = $dhcp_options_id;

		$opt['VpcId'] = $vpc_id;

		return $this->authenticate('AssociateDhcpOptions', $opt);

	}

	/**

	 * Associates a subnet with a route table. The subnet and route table must be in the same VPC.

	 * This association causes traffic originating from the subnet to be routed according to the

	 * routes in the route table. The action returns an association ID, which you need if you want to

	 * disassociate the route table from the subnet later. A route table can be associated with

	 * multiple subnets.

	 *

	 * For more information about route tables, go to <a href=

	 * "http://docs.amazonwebservices.com/AmazonVPC/latest/UserGuide/VPC_Route_Tables.html">Route

	 * Tables</a> in the Amazon Virtual Private Cloud User Guide.

	 *

	 * @param string $subnet_id (Required) The ID of the subnet.

	 * @param string $route_table_id (Required) The ID of the route table.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function associate_route_table($subnet_id, $route_table_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['SubnetId'] = $subnet_id;

		$opt['RouteTableId'] = $route_table_id;

		return $this->authenticate('AssociateRouteTable', $opt);

	}

	/**

	 * Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC.

	 * For more information about your VPC and Internet gateway, go to the Amazon Virtual Private

	 * Cloud User Guide.

	 *

	 * @param string $internet_gateway_id (Required) The ID of the Internet gateway to attach.

	 * @param string $vpc_id (Required) The ID of the VPC.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function attach_internet_gateway($internet_gateway_id, $vpc_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['InternetGatewayId'] = $internet_gateway_id;

		$opt['VpcId'] = $vpc_id;

		return $this->authenticate('AttachInternetGateway', $opt);

	}

	/**

	 * Attach a previously created volume to a running instance.

	 *

	 * @param string $volume_id (Required) The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone and the instance must be running.

	 * @param string $instance_id (Required) The ID of the instance to which the volume attaches. The volume and instance must be within the same Availability Zone and the instance must be running.

	 * @param string $device (Required) Specifies how the device is exposed to the instance (e.g., <code>/dev/sdh</code>).

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function attach_volume($volume_id, $instance_id, $device, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VolumeId'] = $volume_id;

		$opt['InstanceId'] = $instance_id;

		$opt['Device'] = $device;

		return $this->authenticate('AttachVolume', $opt);

	}

	/**

	 * Attaches a VPN gateway to a VPC. This is the last step required to get your VPC fully connected

	 * to your data center before launching instances in it. For more information, go to Process for

	 * Using Amazon VPC in the Amazon Virtual Private Cloud Developer Guide.

	 *

	 * @param string $vpn_gateway_id (Required) The ID of the VPN gateway to attach to the VPC.

	 * @param string $vpc_id (Required) The ID of the VPC to attach to the VPN gateway.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function attach_vpn_gateway($vpn_gateway_id, $vpc_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VpnGatewayId'] = $vpn_gateway_id;

		$opt['VpcId'] = $vpc_id;

		return $this->authenticate('AttachVpnGateway', $opt);

	}

	/**

	 * This action applies only to security groups in a VPC; it's not supported for EC2 security

	 * groups. For information about Amazon Virtual Private Cloud and VPC security groups, go to the

	 * Amazon Virtual Private Cloud User Guide.

	 *

	 * The action adds one or more egress rules to a VPC security group. Specifically, this permits

	 * instances in a security group to send traffic to either one or more destination CIDR IP address

	 * ranges, or to one or more destination security groups in the same VPC.

	 *

	 * Each rule consists of the protocol (e.g., TCP), plus either a CIDR range, or a source group.

	 * For the TCP and UDP protocols, you must also specify the destination port or port range. For

	 * the ICMP protocol, you must also specify the ICMP type and code. You can use <code>-1</code> as

	 * a wildcard for the ICMP type or code.

	 *

	 * Rule changes are propagated to instances within the security group as quickly as possible.

	 * However, a small delay might occur.

	 *

	 * <strong>Important:</strong> For VPC security groups: You can have up to 50 rules total per

	 * group (covering both ingress and egress).

	 *

	 * @param string $group_id (Required) ID of the VPC security group to modify.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>IpPermissions</code> - <code>array</code> - Optional - List of IP permissions to authorize on the specified security group. Specifying permissions through IP permissions is the preferred way of authorizing permissions since it offers more flexibility and control. <ul>

	 * 		<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 			<li><code>IpProtocol</code> - <code>string</code> - Optional - The IP protocol of this permission. Valid protocol values: <code>tcp</code>, <code>udp</code>, <code>icmp</code></li>

	 * 			<li><code>FromPort</code> - <code>integer</code> - Optional - Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of <code>-1</code> indicates a wildcard (i.e., any ICMP type number).</li>

	 * 			<li><code>ToPort</code> - <code>integer</code> - Optional - End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of <code>-1</code> indicates a wildcard (i.e., any ICMP code).</li>

	 * 			<li><code>Groups</code> - <code>array</code> - Optional - The list of AWS user IDs and groups included in this permission. <ul>

	 * 				<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 					<li><code>UserId</code> - <code>string</code> - Optional - The AWS user ID of an account.</li>

	 * 					<li><code>GroupName</code> - <code>string</code> - Optional - Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.</li>

	 * 					<li><code>GroupId</code> - <code>string</code> - Optional - ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.</li>

	 * 				</ul></li>

	 * 			</ul></li>

	 * 			<li><code>IpRanges</code> - <code>string|array</code> - Optional - The list of CIDR IP ranges included in this permission. Pass a string for a single value, or an indexed array for multiple values.</li>

	 * 		</ul></li>

	 * 	</ul></li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function authorize_security_group_egress($group_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['GroupId'] = $group_id;

		// Optional list + map

		if (isset($opt['IpPermissions']))

		{

			$opt = array_merge($opt, CFComplexType::map(array(

				'IpPermissions' => $opt['IpPermissions']

			)));

			unset($opt['IpPermissions']);

		}

		return $this->authenticate('AuthorizeSecurityGroupEgress', $opt);

	}

	/**

	 * The AuthorizeSecurityGroupIngress operation adds permissions to a security group.

	 *

	 * Permissions are specified by the IP protocol (TCP, UDP or ICMP), the source of the request (by

	 * IP range or an Amazon EC2 user-group pair), the source and destination port ranges (for TCP and

	 * UDP), and the ICMP codes and types (for ICMP). When authorizing ICMP, <code>-1</code> can be

	 * used as a wildcard in the type and code fields.

	 *

	 * Permission changes are propagated to instances within the security group as quickly as

	 * possible. However, depending on the number of instances, a small delay might occur.

	 *

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>GroupName</code> - <code>string</code> - Optional - Name of the standard (EC2) security group to modify. The group must belong to your account. Can be used instead of GroupID for standard (EC2) security groups.</li>

	 * 	<li><code>GroupId</code> - <code>string</code> - Optional - ID of the standard (EC2) or VPC security group to modify. The group must belong to your account. Required for VPC security groups; can be used instead of GroupName for standard (EC2) security groups.</li>

	 * 	<li><code>IpPermissions</code> - <code>array</code> - Optional - List of IP permissions to authorize on the specified security group. Specifying permissions through IP permissions is the preferred way of authorizing permissions since it offers more flexibility and control. <ul>

	 * 		<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 			<li><code>IpProtocol</code> - <code>string</code> - Optional - The IP protocol of this permission. Valid protocol values: <code>tcp</code>, <code>udp</code>, <code>icmp</code></li>

	 * 			<li><code>FromPort</code> - <code>integer</code> - Optional - Start of port range for the TCP and UDP protocols, or an ICMP type number. An ICMP type number of <code>-1</code> indicates a wildcard (i.e., any ICMP type number).</li>

	 * 			<li><code>ToPort</code> - <code>integer</code> - Optional - End of port range for the TCP and UDP protocols, or an ICMP code. An ICMP code of <code>-1</code> indicates a wildcard (i.e., any ICMP code).</li>

	 * 			<li><code>Groups</code> - <code>array</code> - Optional - The list of AWS user IDs and groups included in this permission. <ul>

	 * 				<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 					<li><code>UserId</code> - <code>string</code> - Optional - The AWS user ID of an account.</li>

	 * 					<li><code>GroupName</code> - <code>string</code> - Optional - Name of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.</li>

	 * 					<li><code>GroupId</code> - <code>string</code> - Optional - ID of the security group in the specified AWS account. Cannot be used when specifying a CIDR IP address range.</li>

	 * 				</ul></li>

	 * 			</ul></li>

	 * 			<li><code>IpRanges</code> - <code>string|array</code> - Optional - The list of CIDR IP ranges included in this permission. Pass a string for a single value, or an indexed array for multiple values.</li>

	 * 		</ul></li>

	 * 	</ul></li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function authorize_security_group_ingress($opt = null)

	{

		if (!$opt) $opt = array();

		// Optional list + map

		if (isset($opt['IpPermissions']))

		{

			$opt = array_merge($opt, CFComplexType::map(array(

				'IpPermissions' => $opt['IpPermissions']

			)));

			unset($opt['IpPermissions']);

		}

		return $this->authenticate('AuthorizeSecurityGroupIngress', $opt);

	}

	/**

	 * The BundleInstance operation request that an instance is bundled the next time it boots. The

	 * bundling process creates a new image from a running instance and stores the AMI data in S3. Once

	 * bundled, the image must be registered in the normal way using the RegisterImage API.

	 *

	 * @param string $instance_id (Required) The ID of the instance to bundle.

	 * @param array $policy (Required) The details of S3 storage for bundling a Windows instance. Takes an associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Bucket</code> - <code>string</code> - Optional - The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.</li>

	 * 	<li><code>Prefix</code> - <code>string</code> - Optional - The prefix to use when storing the AMI in S3.</li>

	 * 	<li><code>AWSAccessKeyId</code> - <code>string</code> - Optional - The Access Key ID of the owner of the Amazon S3 bucket. Use the <CFPolicy::get_key()> method of a <CFPolicy> instance.</li>

	 * 	<li><code>UploadPolicy</code> - <code>string</code> - Optional - A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf. Use the <CFPolicy::get_policy()> method of a <CFPolicy> instance.</li>

	 * 	<li><code>UploadPolicySignature</code> - <code>string</code> - Optional - The signature of the Base64 encoded JSON document. Use the <CFPolicy::get_policy_signature()> method of a <CFPolicy> instance.</li></ul>

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 *  <li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This is useful for manually-managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function bundle_instance($instance_id, $policy, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['InstanceId'] = $instance_id;

		$opt = array_merge($opt, CFComplexType::map(array(

			'Storage.S3' => $policy

		)));

		return $this->authenticate('BundleInstance', $opt, $this->hostname);

	}

	/**

	 * CancelBundleTask operation cancels a pending or in-progress bundling task. This is an

	 * asynchronous call and it make take a while for the task to be canceled. If a task is canceled

	 * while it is storing items, there may be parts of the incomplete AMI stored in S3. It is up to

	 * the caller to clean up these parts from S3.

	 *

	 * @param string $bundle_id (Required) The ID of the bundle task to cancel.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function cancel_bundle_task($bundle_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['BundleId'] = $bundle_id;

		return $this->authenticate('CancelBundleTask', $opt);

	}

	/**

	 * Cancels one or more Spot Instance requests.

	 *

	 * Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that

	 * you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based

	 * on available Spot Instance capacity and current spot instance requests.

	 *

	 * For conceptual information about Spot Instances, refer to the <a href=

	 * "http://docs.amazonwebservices.com/AWSEC2/2009-11-30/DeveloperGuide/">Amazon Elastic Compute

	 * Cloud Developer Guide</a> or <a href=

	 * "http://docs.amazonwebservices.com/AWSEC2/2009-11-30/UserGuide/">Amazon Elastic Compute Cloud

	 * User Guide</a>.

	 *

	 * @param string|array $spot_instance_request_id (Required) Specifies the ID of the Spot Instance request. Pass a string for a single value, or an indexed array for multiple values.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function cancel_spot_instance_requests($spot_instance_request_id, $opt = null)

	{

		if (!$opt) $opt = array();

		// Required list (non-map)

		$opt = array_merge($opt, CFComplexType::map(array(

			'SpotInstanceRequestId' => (is_array($spot_instance_request_id) ? $spot_instance_request_id : array($spot_instance_request_id))

		)));

		return $this->authenticate('CancelSpotInstanceRequests', $opt);

	}

	/**

	 * The ConfirmProductInstance operation returns true if the specified product code is attached to

	 * the specified instance. The operation returns false if the product code is not attached to the

	 * instance.

	 *

	 * The ConfirmProductInstance operation can only be executed by the owner of the AMI. This feature

	 * is useful when an AMI owner is providing support and wants to verify whether a user's instance

	 * is eligible.

	 *

	 * @param string $product_code (Required) The product code to confirm.

	 * @param string $instance_id (Required) The ID of the instance to confirm.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function confirm_product_instance($product_code, $instance_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['ProductCode'] = $product_code;

		$opt['InstanceId'] = $instance_id;

		return $this->authenticate('ConfirmProductInstance', $opt);

	}

	/**

	 * Provides information to AWS about your customer gateway device. The customer gateway is the

	 * appliance at your end of the VPN connection (compared to the VPN gateway, which is the device

	 * at the AWS side of the VPN connection). You can have a single active customer gateway per AWS

	 * account (active means that you've created a VPN connection to use with the customer gateway).

	 * AWS might delete any customer gateway that you create with this operation if you leave it

	 * inactive for an extended period of time.

	 *

	 * You must provide the Internet-routable IP address of the customer gateway's external interface.

	 * The IP address must be static.

	 *

	 * You must also provide the device's Border Gateway Protocol (BGP) Autonomous System Number

	 * (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already,

	 * you can use a private ASN (in the 64512 - 65534 range). For more information about ASNs, go to

	 * 	<a href=

	 * "http://en.wikipedia.org/wiki/Autonomous_system_%28Internet%29">http://en.wikipedia.org/wiki/Autonomous_system_%28Internet%29</a>.

	 *

	 * @param string $type (Required) The type of VPN connection this customer gateway supports.

	 * @param string $ip_address (Required) The Internet-routable IP address for the customer gateway's outside interface. The address must be static

	 * @param integer $bgp_asn (Required) The customer gateway's Border Gateway Protocol (BGP) Autonomous System Number (ASN).

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_customer_gateway($type, $ip_address, $bgp_asn, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['Type'] = $type;

		$opt['IpAddress'] = $ip_address;

		$opt['BgpAsn'] = $bgp_asn;

		return $this->authenticate('CreateCustomerGateway', $opt);

	}

	/**

	 * Creates a set of DHCP options that you can then associate with one or more VPCs, causing all

	 * existing and new instances that you launch in those VPCs to use the set of DHCP options. The

	 * following table lists the individual DHCP options you can specify. For more information about

	 * the options, go to <a href=

	 * "http://www.ietf.org/rfc/rfc2132.txt">http://www.ietf.org/rfc/rfc2132.txt</a>

	 *

	 * @param array $dhcp_configuration (Required) A set of one or more DHCP configurations. <ul>

	 * 	<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 		<li><code>Key</code> - <code>string</code> - Optional - Contains the name of a DHCP option.</li>

	 * 		<li><code>Value</code> - <code>string|array</code> - Optional - Contains a set of values for a DHCP option. Pass a string for a single value, or an indexed array for multiple values.</li>

	 * 	</ul></li>

	 * </ul>

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_dhcp_options($dhcp_configuration, $opt = null)

	{

		if (!$opt) $opt = array();

		// Required list + map

		$opt = array_merge($opt, CFComplexType::map(array(

			'DhcpConfiguration' => (is_array($dhcp_configuration) ? $dhcp_configuration : array($dhcp_configuration))

		)));

		return $this->authenticate('CreateDhcpOptions', $opt);

	}

	/**

	 * Creates an Amazon EBS-backed AMI from a "running" or "stopped" instance. AMIs that use an

	 * Amazon EBS root device boot faster than AMIs that use instance stores. They can be up to 1 TiB

	 * in size, use storage that persists on instance failure, and can be stopped and started.

	 *

	 * @param string $instance_id (Required) The ID of the instance from which to create the new image.

	 * @param string $name (Required) The name for the new AMI being created.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Description</code> - <code>string</code> - Optional - The description for the new AMI being created.</li>

	 * 	<li><code>NoReboot</code> - <code>boolean</code> - Optional - By default this property is set to <code>false</code>, which means Amazon EC2 attempts to cleanly shut down the instance before image creation and reboots the instance afterwards. When set to true, Amazon EC2 will not shut down the instance before creating the image. When this option is used, file system integrity on the created image cannot be guaranteed.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_image($instance_id, $name, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['InstanceId'] = $instance_id;

		$opt['Name'] = $name;

		return $this->authenticate('CreateImage', $opt);

	}

	/**

	 * Creates a new Internet gateway in your AWS account. After creating the Internet gateway, you

	 * then attach it to a VPC using <code>AttachInternetGateway</code>. For more information about

	 * your VPC and Internet gateway, go to Amazon Virtual Private Cloud User Guide.

	 *

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_internet_gateway($opt = null)

	{

		if (!$opt) $opt = array();

		return $this->authenticate('CreateInternetGateway', $opt);

	}

	/**

	 * The CreateKeyPair operation creates a new 2048 bit RSA key pair and returns a unique ID that

	 * can be used to reference this key pair when launching new instances. For more information, see

	 * RunInstances.

	 *

	 * @param string $key_name (Required) The unique name for the new key pair.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_key_pair($key_name, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['KeyName'] = $key_name;

		return $this->authenticate('CreateKeyPair', $opt);

	}

	/**

	 * Creates a new network ACL in a VPC. Network ACLs provide an optional layer of security (on top

	 * of security groups) for the instances in your VPC. For more information about network ACLs, go

	 * to Network ACLs in the Amazon Virtual Private Cloud User Guide.

	 *

	 * @param string $vpc_id (Required) The ID of the VPC where the network ACL will be created.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_network_acl($vpc_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VpcId'] = $vpc_id;

		return $this->authenticate('CreateNetworkAcl', $opt);

	}

	/**

	 * Creates an entry (i.e., rule) in a network ACL with a rule number you specify. Each network ACL

	 * has a set of numbered ingress rules and a separate set of numbered egress rules. When

	 * determining whether a packet should be allowed in or out of a subnet associated with the ACL,

	 * Amazon VPC processes the entries in the ACL according to the rule numbers, in ascending order.

	 *

	 * <strong>Important:</strong> We recommend that you leave room between the rules (e.g., 100, 110,

	 * 120, etc.), and not number them sequentially (101, 102, 103, etc.). This allows you to easily

	 * add a new rule between existing ones without having to renumber the rules.

	 *

	 * After you add an entry, you can't modify it; you must either replace it, or create a new entry

	 * and delete the old one.

	 *

	 * For more information about network ACLs, go to Network ACLs in the Amazon Virtual Private Cloud

	 * User Guide.

	 *

	 * @param string $network_acl_id (Required) ID of the ACL where the entry will be created.

	 * @param integer $rule_number (Required) Rule number to assign to the entry (e.g., 100). ACL entries are processed in ascending order by rule number.

	 * @param string $protocol (Required) IP protocol the rule applies to. Valid Values: <code>tcp</code>, <code>udp</code>, <code>icmp</code> or an IP protocol number.

	 * @param string $rule_action (Required) Whether to allow or deny traffic that matches the rule. [Allowed values: <code>allow</code>, <code>deny</code>]

	 * @param boolean $egress (Required) Whether this rule applies to egress traffic from the subnet (<code>true</code>) or ingress traffic to the subnet (<code>false</code>).

	 * @param string $cidr_block (Required) The CIDR range to allow or deny, in CIDR notation (e.g., <code>172.16.0.0/24</code>).

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Icmp</code> - <code>array</code> - Optional - ICMP values. <ul>

	 * 		<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 			<li><code>Type</code> - <code>integer</code> - Optional - For the ICMP protocol, the ICMP type. A value of <code>-1</code> is a wildcard meaning all types. Required if specifying <code>icmp</code> for the protocol.</li>

	 * 			<li><code>Code</code> - <code>integer</code> - Optional - For the ICMP protocol, the ICMP code. A value of <code>-1</code> is a wildcard meaning all codes. Required if specifying <code>icmp</code> for the protocol.</li>

	 * 		</ul></li>

	 * 	</ul></li>

	 * 	<li><code>PortRange</code> - <code>array</code> - Optional - Port ranges. <ul>

	 * 		<li><code>x</code> - <code>array</code> - Optional - This represents a simple array index. <ul>

	 * 			<li><code>From</code> - <code>integer</code> - Optional - The first port in the range. Required if specifying <code>tcp</code> or <code>udp</code> for the protocol.</li>

	 * 			<li><code>To</code> - <code>integer</code> - Optional - The last port in the range. Required if specifying <code>tcp</code> or <code>udp</code> for the protocol.</li>

	 * 		</ul></li>

	 * 	</ul></li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_network_acl_entry($network_acl_id, $rule_number, $protocol, $rule_action, $egress, $cidr_block, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['NetworkAclId'] = $network_acl_id;

		$opt['RuleNumber'] = $rule_number;

		$opt['Protocol'] = $protocol;

		$opt['RuleAction'] = $rule_action;

		$opt['Egress'] = $egress;

		$opt['CidrBlock'] = $cidr_block;

		// Optional map (non-list)

		if (isset($opt['Icmp']))

		{

			$opt = array_merge($opt, CFComplexType::map(array(

				'Icmp' => $opt['Icmp']

			)));

			unset($opt['Icmp']);

		}

		// Optional map (non-list)

		if (isset($opt['PortRange']))

		{

			$opt = array_merge($opt, CFComplexType::map(array(

				'PortRange' => $opt['PortRange']

			)));

			unset($opt['PortRange']);

		}

		return $this->authenticate('CreateNetworkAclEntry', $opt);

	}

	/**

	 * Creates a <code>PlacementGroup</code> into which multiple Amazon EC2 instances can be launched.

	 * Users must give the group a name unique within the scope of the user account.

	 *

	 * @param string $group_name (Required) The name of the <code>PlacementGroup</code>.

	 * @param string $strategy (Required) The <code>PlacementGroup</code> strategy. [Allowed values: <code>cluster</code>]

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_placement_group($group_name, $strategy, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['GroupName'] = $group_name;

		$opt['Strategy'] = $strategy;

		return $this->authenticate('CreatePlacementGroup', $opt);

	}

	/**

	 * Creates a new route in a route table within a VPC. The route's target can be either a gateway

	 * attached to the VPC or a NAT instance in the VPC.

	 *

	 * When determining how to route traffic, we use the route with the most specific match. For

	 * example, let's say the traffic is destined for <code>192.0.2.3</code>, and the route table

	 * includes the following two routes:

	 *

	 * <ul>

	 * 	<li><code>192.0.2.0/24</code> (goes to some target A)</li>

	 * 	<li><code>192.0.2.0/28</code> (goes to some target B)</li>

	 * </ul>

	 *

	 * Both routes apply to the traffic destined for <code>192.0.2.3</code>. However, the second route

	 * in the list is more specific, so we use that route to determine where to target the traffic.

	 *

	 * For more information about route tables, go to <a href=

	 * "http://docs.amazonwebservices.com/AmazonVPC/latest/UserGuide/VPC_Route_Tables.html">Route

	 * Tables</a> in the Amazon Virtual Private Cloud User Guide.

	 *

	 * @param string $route_table_id (Required) The ID of the route table where the route will be added.

	 * @param string $destination_cidr_block (Required) The CIDR address block used for the destination match. For example: <code>0.0.0.0/0</code>. Routing decisions are based on the most specific match.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>GatewayId</code> - <code>string</code> - Optional - The ID of a VPN or Internet gateway attached to your VPC. You must provide either <code>GatewayId</code> or <code>InstanceId</code>, but not both.</li>

	 * 	<li><code>InstanceId</code> - <code>string</code> - Optional - The ID of a NAT instance in your VPC. You must provide either <code>GatewayId</code> or <code>InstanceId</code>, but not both.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_route($route_table_id, $destination_cidr_block, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['RouteTableId'] = $route_table_id;

		$opt['DestinationCidrBlock'] = $destination_cidr_block;

		return $this->authenticate('CreateRoute', $opt);

	}

	/**

	 * Creates a new route table within a VPC. After you create a new route table, you can add routes

	 * and associate the table with a subnet. For more information about route tables, go to <a href=

	 * "http://docs.amazonwebservices.com/AmazonVPC/latest/UserGuide/VPC_Route_Tables.html">Route

	 * Tables</a> in the Amazon Virtual Private Cloud User Guide.

	 *

	 * @param string $vpc_id (Required) The ID of the VPC where the route table will be created.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_route_table($vpc_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VpcId'] = $vpc_id;

		return $this->authenticate('CreateRouteTable', $opt);

	}

	/**

	 * The CreateSecurityGroup operation creates a new security group.

	 *

	 * Every instance is launched in a security group. If no security group is specified during

	 * launch, the instances are launched in the default security group. Instances within the same

	 * security group have unrestricted network access to each other. Instances will reject network

	 * access attempts from other instances in a different security group. As the owner of instances

	 * you can grant or revoke specific permissions using the AuthorizeSecurityGroupIngress and

	 * RevokeSecurityGroupIngress operations.

	 *

	 * @param string $group_name (Required) Name of the security group.

	 * @param string $group_description (Required) Description of the group. This is informational only.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>VpcId</code> - <code>string</code> - Optional - ID of the VPC.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_security_group($group_name, $group_description, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['GroupName'] = $group_name;

		$opt['GroupDescription'] = $group_description;

		return $this->authenticate('CreateSecurityGroup', $opt);

	}

	/**

	 * Create a snapshot of the volume identified by volume ID. A volume does not have to be detached

	 * at the time the snapshot is taken.

	 *

	 * <p class="note">

	 * Snapshot creation requires that the system is in a consistent state. For instance, this means

	 * that if taking a snapshot of a database, the tables must be read-only locked to ensure that the

	 * snapshot will not contain a corrupted version of the database. Therefore, be careful when using

	 * this API to ensure that the system remains in the consistent state until the create snapshot

	 * status has returned.

	 * </p>

	 *

	 * @param string $volume_id (Required) The ID of the volume from which to create the snapshot.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Description</code> - <code>string</code> - Optional - The description for the new snapshot.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_snapshot($volume_id, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VolumeId'] = $volume_id;

		return $this->authenticate('CreateSnapshot', $opt);

	}

	/**

	 * Creates the data feed for Spot Instances, enabling you to view Spot Instance usage logs. You

	 * can create one data feed per account.

	 *

	 * For conceptual information about Spot Instances, refer to the <a href=

	 * "http://docs.amazonwebservices.com/AWSEC2/2009-11-30/DeveloperGuide/">Amazon Elastic Compute

	 * Cloud Developer Guide</a> or <a href=

	 * "http://docs.amazonwebservices.com/AWSEC2/2009-11-30/UserGuide/">Amazon Elastic Compute Cloud

	 * User Guide</a>.

	 *

	 * @param string $bucket (Required) The Amazon S3 bucket in which to store the Spot Instance datafeed.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>Prefix</code> - <code>string</code> - Optional - The prefix that is prepended to datafeed files.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_spot_datafeed_subscription($bucket, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['Bucket'] = $bucket;

		return $this->authenticate('CreateSpotDatafeedSubscription', $opt);

	}

	/**

	 * Creates a subnet in an existing VPC. You can create up to 20 subnets in a VPC. If you add more

	 * than one subnet to a VPC, they're set up in a star topology with a logical router in the

	 * middle. When you create each subnet, you provide the VPC ID and the CIDR block you want for the

	 * subnet. Once you create a subnet, you can't change its CIDR block. The subnet's CIDR block can

	 * be the same as the VPC's CIDR block (assuming you want only a single subnet in the VPC), or a

	 * subset of the VPC's CIDR block. If you create more than one subnet in a VPC, the subnets' CIDR

	 * blocks must not overlap. The smallest subnet (and VPC) you can create uses a <code>/28</code>

	 * netmask (16 IP addresses), and the largest uses a <code>/18</code> netmask (16,384 IP

	 * addresses).

	 *

	 * <p class="important"></p>

	 * AWS reserves both the first four and the last IP address in each subnet's CIDR block. They're

	 * not available for use.

	 *

	 * @param string $vpc_id (Required) The ID of the VPC to create the subnet in.

	 * @param string $cidr_block (Required) The CIDR block the subnet is to cover.

	 * @param array $opt (Optional) An associative array of parameters that can have the following keys: <ul>

	 * 	<li><code>AvailabilityZone</code> - <code>string</code> - Optional - The Availability Zone to create the subnet in.</li>

	 * 	<li><code>curlopts</code> - <code>array</code> - Optional - A set of values to pass directly into <code>curl_setopt()</code>, where the key is a pre-defined <code>CURLOPT_*</code> constant.</li>

	 * 	<li><code>returnCurlHandle</code> - <code>boolean</code> - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.</li></ul>

	 * @return CFResponse A <CFResponse> object containing a parsed HTTP response.

	 */

	public function create_subnet($vpc_id, $cidr_block, $opt = null)

	{

		if (!$opt) $opt = array();

		$opt['VpcId'] = $vpc_id;

		$opt['CidrBlock'] = $cidr_block;

		return $this->authenticate('CreateSubnet', $opt);

	}

	/**

	 * Adds or overwrites tags for the specified resources. Each resource can have a maximum of 10

	 * tags. Each tag consists of a key-value pair. Tag keys must be unique per resource.

	 *

	 * @param string|array $resource_id (Required) One or more IDs of resources to tag. This could be the ID of an AMI, an instance, an EBS volume, or snapshot, etc. Pass a string for a single value, or an indexed array for multiple values.

	 * @param array $tag (Required) The tags to add or overwrite for the specified resources. Each tag item consists of a key-value pair. <ul>