/** * 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')); }