/**
* Describe Images
* The DescribeImages operation returns information about AMIs, AKIs, and ARIs
* available to the user. Information returned includes image type, product codes,
* architecture, and kernel and RAM disk IDs. Images available to the user include
* public images available for any user to launch, private images owned by the
* user making the request, and private images owned by other users for which the
* user has explicit launch permissions.
* Launch permissions fall into three categories:
* Public:
* The owner of the AMI granted launch permissions for the AMI to the all group.
* All users have launch permissions for these AMIs.
* Explicit:
* The owner of the AMI granted launch permissions to a specific user.
* Implicit:
* A user has implicit launch permissions for all AMIs he or she owns.
* The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or
* users with launch permissions. If no options are specified, Amazon EC2 returns
* all AMIs for which the user has launch permissions.
* If you specify one or more AMI IDs, only AMIs that have the specified IDs are
* returned. If you specify an invalid AMI ID, a fault is returned. If you specify
* an AMI ID for which you do not have access, it will not be included in the
* returned results.
* If you specify one or more AMI owners, only AMIs from the specified owners and
* for which you have access are returned. The results can include the account IDs
* of the specified owners, amazon for AMIs owned by Amazon or self for AMIs that
* you own.
* If you specify a list of executable users, only users that have launch
* permissions for the AMIs are returned. You can specify account IDs (if you own
* the AMI(s)), self for AMIs for which you own or have explicit permissions, or
* all for public AMIs.
* Note:
* Deregistered images are included in the returned results for an unspecified
* interval after deregistration.
*
* @see http://docs.amazonwebservices.com/AWSEC2/2008-12-01/DeveloperGuide/ApiReference-Query-DescribeImages.html
* @param mixed $request array of parameters for Amazon_EC2_Model_DescribeImagesRequest request
* or Amazon_EC2_Model_DescribeImagesRequest object itself
* @see Amazon_EC2_Model_DescribeImages
* @return Amazon_EC2_Model_DescribeImagesResponse Amazon_EC2_Model_DescribeImagesResponse
*
* @throws Amazon_EC2_Exception
*/
public function describeImages($request)
{
if (!$request instanceof Amazon_EC2_Model_DescribeImagesRequest) {
require_once 'Amazon/EC2/Model/DescribeImagesRequest.php';
$request = new Amazon_EC2_Model_DescribeImagesRequest($request);
}
require_once 'Amazon/EC2/Model/DescribeImagesResponse.php';
return Amazon_EC2_Model_DescribeImagesResponse::fromXML($this->_invoke($this->_convertDescribeImages($request)));
}
/**
* Describe Images
* The DescribeImages operation returns information about AMIs, AKIs, and ARIs
* available to the user. Information returned includes image type, product codes,
* architecture, and kernel and RAM disk IDs. Images available to the user include
* public images available for any user to launch, private images owned by the
* user making the request, and private images owned by other users for which the
* user has explicit launch permissions.
* Launch permissions fall into three categories:
* Public:
* The owner of the AMI granted launch permissions for the AMI to the all group.
* All users have launch permissions for these AMIs.
* Explicit:
* The owner of the AMI granted launch permissions to a specific user.
* Implicit:
* A user has implicit launch permissions for all AMIs he or she owns.
* The list of AMIs returned can be modified by specifying AMI IDs, AMI owners, or
* users with launch permissions. If no options are specified, Amazon EC2 returns
* all AMIs for which the user has launch permissions.
* If you specify one or more AMI IDs, only AMIs that have the specified IDs are
* returned. If you specify an invalid AMI ID, a fault is returned. If you specify
* an AMI ID for which you do not have access, it will not be included in the
* returned results.
* If you specify one or more AMI owners, only AMIs from the specified owners and
* for which you have access are returned. The results can include the account IDs
* of the specified owners, amazon for AMIs owned by Amazon or self for AMIs that
* you own.
* If you specify a list of executable users, only users that have launch
* permissions for the AMIs are returned. You can specify account IDs (if you own
* the AMI(s)), self for AMIs for which you own or have explicit permissions, or
* all for public AMIs.
* Note:
* Deregistered images are included in the returned results for an unspecified
* interval after deregistration.
*
* @see http://docs.amazonwebservices.com/AWSEC2/2008-12-01/DeveloperGuide/ApiReference-Query-DescribeImages.html
* @param mixed $request array of parameters for Amazon_EC2_Model_DescribeImages request or Amazon_EC2_Model_DescribeImages object itself
* @see Amazon_EC2_Model_DescribeImages
* @return Amazon_EC2_Model_DescribeImagesResponse Amazon_EC2_Model_DescribeImagesResponse
*
* @throws Amazon_EC2_Exception
*/
public function describeImages($request)
{
require_once 'Amazon/EC2/Model/DescribeImagesResponse.php';
return Amazon_EC2_Model_DescribeImagesResponse::fromXML($this->_invoke('DescribeImages'));
}
