[Summary view] [Print] [Text view]

   1  <?php
   2  /**
   3   * Zend Framework
   4   *
   5   * LICENSE
   6   *
   7   * This source file is subject to the new BSD license that is bundled
   8   * with this package in the file LICENSE.txt.
   9   * It is also available through the world-wide-web at this URL:
  10   * http://framework.zend.com/license/new-bsd
  11   * If you did not receive a copy of the license and are unable to
  12   * obtain it through the world-wide-web, please send an email
  13   * to [email protected] so we can send you a copy immediately.
  14   *
  15   * @category   Zend
  16   * @package    Zend_Service_Amazon
  17   * @subpackage Ec2
  18   * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  19   * @license    http://framework.zend.com/license/new-bsd     New BSD License
  20   * @version    $Id$
  21   */
  22  
  23  /**
  24   * @see Zend_Service_Amazon_Ec2_Abstract
  25   */
  26  require_once 'Zend/Service/Amazon/Ec2/Abstract.php';
  27  
  28  /**
  29   * An Amazon EC2 interface to create, delete and describe Ec2 KeyPairs.
  30   *
  31   * @category   Zend
  32   * @package    Zend_Service_Amazon
  33   * @subpackage Ec2
  34   * @copyright  Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
  35   * @license    http://framework.zend.com/license/new-bsd     New BSD License
  36   */
  37  class Zend_Service_Amazon_Ec2_Keypair extends Zend_Service_Amazon_Ec2_Abstract
  38  {
  39      /**
  40       * Creates a new 2048 bit RSA key pair and returns a unique ID that can
  41       * be used to reference this key pair when launching new instances.
  42       *
  43       * @param string $keyName           A unique name for the key pair.
  44       * @throws Zend_Service_Amazon_Ec2_Exception
  45       * @return array
  46       */
  47      public function create($keyName)
  48      {
  49          $params = array();
  50  
  51          $params['Action'] = 'CreateKeyPair';
  52  
  53          if(!$keyName) {
  54              require_once 'Zend/Service/Amazon/Ec2/Exception.php';
  55              throw new Zend_Service_Amazon_Ec2_Exception('Invalid Key Name');
  56          }
  57  
  58          $params['KeyName'] = $keyName;
  59  
  60          $response = $this->sendRequest($params);
  61          $xpath = $response->getXPath();
  62  
  63          $return = array();
  64          $return['keyName']          = $xpath->evaluate('string(//ec2:keyName/text())');
  65          $return['keyFingerprint']   = $xpath->evaluate('string(//ec2:keyFingerprint/text())');
  66          $return['keyMaterial']      = $xpath->evaluate('string(//ec2:keyMaterial/text())');
  67  
  68          return $return;
  69      }
  70  
  71      /**
  72       * Returns information about key pairs available to you. If you specify
  73       * key pairs, information about those key pairs is returned. Otherwise,
  74       * information for all registered key pairs is returned.
  75       *
  76       * @param string|rarray $keyName    Key pair IDs to describe.
  77       * @return array
  78       */
  79      public function describe($keyName = null)
  80      {
  81          $params = array();
  82  
  83          $params['Action'] = 'DescribeKeyPairs';
  84          if(is_array($keyName) && !empty($keyName)) {
  85              foreach($keyName as $k=>$name) {
  86                  $params['KeyName.' . ($k+1)] = $name;
  87              }
  88          } elseif($keyName) {
  89              $params['KeyName.1'] = $keyName;
  90          }
  91  
  92          $response = $this->sendRequest($params);
  93          $xpath = $response->getXPath();
  94  
  95          $nodes  = $xpath->query('//ec2:keySet/ec2:item');
  96  
  97          $return = array();
  98          foreach ($nodes as $k => $node) {
  99              $item = array();
 100              $item['keyName']          = $xpath->evaluate('string(ec2:keyName/text())', $node);
 101              $item['keyFingerprint']   = $xpath->evaluate('string(ec2:keyFingerprint/text())', $node);
 102  
 103              $return[] = $item;
 104              unset($item);
 105          }
 106  
 107          return $return;
 108      }
 109  
 110      /**
 111       * Deletes a key pair
 112       *
 113       * @param string $keyName           Name of the key pair to delete.
 114       * @throws Zend_Service_Amazon_Ec2_Exception
 115       * @return boolean                  Return true or false from the deletion.
 116       */
 117      public function delete($keyName)
 118      {
 119          $params = array();
 120  
 121          $params['Action'] = 'DeleteKeyPair';
 122  
 123          if(!$keyName) {
 124              require_once 'Zend/Service/Amazon/Ec2/Exception.php';
 125              throw new Zend_Service_Amazon_Ec2_Exception('Invalid Key Name');
 126          }
 127  
 128          $params['KeyName'] = $keyName;
 129  
 130          $response = $this->sendRequest($params);
 131  
 132          $xpath = $response->getXPath();
 133          $success  = $xpath->evaluate('string(//ec2:return/text())');
 134  
 135          return ($success === "true");
 136      }
 137  }