/**
* Run Instances
* The RunInstances operation launches a specified number of instances.
* If Amazon EC2 cannot launch the minimum number AMIs you request, no instances
* launch. If there is insufficient capacity to launch the maximum number of AMIs
* you request, Amazon EC2 launches as many as possible to satisfy the requested
* maximum values.
* Every instance is launched in a security group. If you do not specify a
* security group at launch, the instances start in your default security group.
* For more information on creating security groups, see CreateSecurityGroup.
* An optional instance type can be specified. For information about instance
* types, see Instance Types.
* You can provide an optional key pair ID for each image in the launch request
* (for more information, see CreateKeyPair). All instances that are created from
* images that use this key pair will have access to the associated public key at
* boot. You can use this key to provide secure access to an instance of an image
* on a per-instance basis. Amazon EC2 public images use this feature to provide
* secure access without passwords.
* Important:
* Launching public images without a key pair ID will leave them inaccessible.
* The public key material is made available to the instance at boot time by
* placing it in the openssh_id.pub file on a logical device that is exposed to
* the instance as /dev/sda2 (the ephemeral store). The format of this file is
* suitable for use as an entry within ~/.ssh/authorized_keys (the OpenSSH
* format). This can be done at boot (e.g., as part of rc.local) allowing for
* secure access without passwords.
* Optional user data can be provided in the launch request. All instances that
* collectively comprise the launch request have access to this data For more
* information, see Instance Metadata.
* Note:
* If any of the AMIs have a product code attached for which the user has not
* subscribed, the RunInstances call will fail.
* Important:
* We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and
* c1.xlarge instances. Although the default Amazon EC2 kernels will work, the new
* kernels provide greater stability and performance for these instance types. For
* more information about kernels, see Kernels, RAM Disks, and Block Device
* Mappings.
*
* @see http://docs.amazonwebservices.com/AWSEC2/2008-12-01/DeveloperGuide/ApiReference-Query-RunInstances.html
* @param mixed $request array of parameters for Amazon_EC2_Model_RunInstancesRequest request
* or Amazon_EC2_Model_RunInstancesRequest object itself
* @see Amazon_EC2_Model_RunInstances
* @return Amazon_EC2_Model_RunInstancesResponse Amazon_EC2_Model_RunInstancesResponse
*
* @throws Amazon_EC2_Exception
*/
public function runInstances($request)
{
if (!$request instanceof Amazon_EC2_Model_RunInstancesRequest) {
require_once 'Amazon/EC2/Model/RunInstancesRequest.php';
$request = new Amazon_EC2_Model_RunInstancesRequest($request);
}
require_once 'Amazon/EC2/Model/RunInstancesResponse.php';
return Amazon_EC2_Model_RunInstancesResponse::fromXML($this->_invoke($this->_convertRunInstances($request)));
}
/**
* Run Instances
* The RunInstances operation launches a specified number of instances.
* If Amazon EC2 cannot launch the minimum number AMIs you request, no instances
* launch. If there is insufficient capacity to launch the maximum number of AMIs
* you request, Amazon EC2 launches as many as possible to satisfy the requested
* maximum values.
* Every instance is launched in a security group. If you do not specify a
* security group at launch, the instances start in your default security group.
* For more information on creating security groups, see CreateSecurityGroup.
* An optional instance type can be specified. For information about instance
* types, see Instance Types.
* You can provide an optional key pair ID for each image in the launch request
* (for more information, see CreateKeyPair). All instances that are created from
* images that use this key pair will have access to the associated public key at
* boot. You can use this key to provide secure access to an instance of an image
* on a per-instance basis. Amazon EC2 public images use this feature to provide
* secure access without passwords.
* Important:
* Launching public images without a key pair ID will leave them inaccessible.
* The public key material is made available to the instance at boot time by
* placing it in the openssh_id.pub file on a logical device that is exposed to
* the instance as /dev/sda2 (the ephemeral store). The format of this file is
* suitable for use as an entry within ~/.ssh/authorized_keys (the OpenSSH
* format). This can be done at boot (e.g., as part of rc.local) allowing for
* secure access without passwords.
* Optional user data can be provided in the launch request. All instances that
* collectively comprise the launch request have access to this data For more
* information, see Instance Metadata.
* Note:
* If any of the AMIs have a product code attached for which the user has not
* subscribed, the RunInstances call will fail.
* Important:
* We strongly recommend using the 2.6.18 Xen stock kernel with the c1.medium and
* c1.xlarge instances. Although the default Amazon EC2 kernels will work, the new
* kernels provide greater stability and performance for these instance types. For
* more information about kernels, see Kernels, RAM Disks, and Block Device
* Mappings.
*
* @see http://docs.amazonwebservices.com/AWSEC2/2008-12-01/DeveloperGuide/ApiReference-Query-RunInstances.html
* @param mixed $request array of parameters for Amazon_EC2_Model_RunInstances request or Amazon_EC2_Model_RunInstances object itself
* @see Amazon_EC2_Model_RunInstances
* @return Amazon_EC2_Model_RunInstancesResponse Amazon_EC2_Model_RunInstancesResponse
*
* @throws Amazon_EC2_Exception
*/
public function runInstances($request)
{
require_once 'Amazon/EC2/Model/RunInstancesResponse.php';
return Amazon_EC2_Model_RunInstancesResponse::fromXML($this->_invoke('RunInstances'));
}
