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 license@zend.com 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: Reserved.php 20096 2010-01-06 02:05:09Z bkarwin $

    21  */

    22 

    23 /**

    24  * @see Zend_Service_Amazon_Ec2_Abstract

    25  */

    26 require_once 'Zend/Service/Amazon/Ec2/Abstract.php';

    27 

    28 /**

    29  * Allows you to interface with the reserved instances on Amazon Ec2

    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_Instance_Reserved extends Zend_Service_Amazon_Ec2_Abstract

    38 {

    39     /**

    40      * Describes Reserved Instances that you purchased.

    41      *

    42      * @param string|array $instanceId        IDs of the Reserved Instance to describe.

    43      * @return array

    44      */

    45     public function describeInstances($instanceId)

    46     {

    47         $params = array();

    48         $params['Action'] = 'DescribeReservedInstances';

    49 

    50         if(is_array($instanceId) && !empty($instanceId)) {

    51             foreach($instanceId as $k=>$name) {

    52                 $params['ReservedInstancesId.' . ($k+1)] = $name;

    53             }

    54         } elseif($instanceId) {

    55             $params['ReservedInstancesId.1'] = $instanceId;

    56         }

    57 

    58         $response = $this->sendRequest($params);

    59 

    60         $xpath = $response->getXPath();

    61         $items = $xpath->query('//ec2:reservedInstancesSet/ec2:item');

    62 

    63         $return = array();

    64         foreach($items as $item) {

    65             $i = array();

    66             $i['reservedInstancesId'] = $xpath->evaluate('string(ec2:reservedInstancesId/text())', $item);

    67             $i['instanceType'] = $xpath->evaluate('string(ec2:instanceType/text())', $item);

    68             $i['availabilityZone'] = $xpath->evaluate('string(ec2:availabilityZone/text())', $item);

    69             $i['duration'] = $xpath->evaluate('string(ec2:duration/text())', $item);

    70             $i['fixedPrice'] = $xpath->evaluate('string(ec2:fixedPrice/text())', $item);

    71             $i['usagePrice'] = $xpath->evaluate('string(ec2:usagePrice/text())', $item);

    72             $i['productDescription'] = $xpath->evaluate('string(ec2:productDescription/text())', $item);

    73             $i['instanceCount'] = $xpath->evaluate('string(ec2:instanceCount/text())', $item);

    74             $i['state'] = $xpath->evaluate('string(ec2:state/text())', $item);

    75 

    76             $return[] = $i;

    77             unset($i);

    78         }

    79 

    80         return $return;

    81     }

    82 

    83     /**

    84      * Describes Reserved Instance offerings that are available for purchase.

    85      * With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon

    86      * EC2 instances for a period of time (without getting insufficient capacity

    87      * errors) and pay a lower usage rate for the actual time used.

    88      *

    89      * @return array

    90      */

    91     public function describeOfferings()

    92     {

    93         $params = array();

    94         $params['Action'] = 'DescribeReservedInstancesOfferings';

    95 

    96         $response = $this->sendRequest($params);

    97 

    98         $xpath = $response->getXPath();

    99         $items = $xpath->query('//ec2:reservedInstancesOfferingsSet/ec2:item');

   100 

   101         $return = array();

   102         foreach($items as $item) {

   103             $i = array();

   104             $i['reservedInstancesOfferingId'] = $xpath->evaluate('string(ec2:reservedInstancesOfferingId/text())', $item);

   105             $i['instanceType'] = $xpath->evaluate('string(ec2:instanceType/text())', $item);

   106             $i['availabilityZone'] = $xpath->evaluate('string(ec2:availabilityZone/text())', $item);

   107             $i['duration'] = $xpath->evaluate('string(ec2:duration/text())', $item);

   108             $i['fixedPrice'] = $xpath->evaluate('string(ec2:fixedPrice/text())', $item);

   109             $i['usagePrice'] = $xpath->evaluate('string(ec2:usagePrice/text())', $item);

   110             $i['productDescription'] = $xpath->evaluate('string(ec2:productDescription/text())', $item);

   111 

   112             $return[] = $i;

   113             unset($i);

   114         }

   115 

   116         return $return;

   117     }

   118 

   119     /**

   120      * Purchases a Reserved Instance for use with your account. With Amazon EC2

   121      * Reserved Instances, you purchase the right to launch Amazon EC2 instances

   122      * for a period of time (without getting insufficient capacity errors) and

   123      * pay a lower usage rate for the actual time used.

   124      *

   125      * @param string $offeringId            The offering ID of the Reserved Instance to purchase

   126      * @param integer $intanceCount         The number of Reserved Instances to purchase.

   127      * @return string                       The ID of the purchased Reserved Instances.

   128      */

   129     public function purchaseOffering($offeringId, $intanceCount = 1)

   130     {

   131         $params = array();

   132         $params['Action'] = 'PurchaseReservedInstancesOffering';

   133         $params['OfferingId.1'] = $offeringId;

   134         $params['instanceCount.1'] = intval($intanceCount);

   135 

   136         $response = $this->sendRequest($params);

   137 

   138         $xpath = $response->getXPath();

   139         $reservedInstancesId = $xpath->evaluate('string(//ec2:reservedInstancesId/text())');

   140 

   141         return $reservedInstancesId;

   142     }

   143 }