1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
<?php
/**
* Zend Framework
*
* LICENSE
*
* This source file is subject to the new BSD license that is bundled
* with this package in the file LICENSE.txt.
* It is also available through the world-wide-web at this URL:
* http://framework.zend.com/license/new-bsd
* If you did not receive a copy of the license and are unable to
* obtain it through the world-wide-web, please send an email
* to license@zend.com so we can send you a copy immediately.
*
* @category Zend
* @package Zend_Service_Amazon
* @subpackage Ec2
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
* @version $Id: Elasticip.php 20096 2010-01-06 02:05:09Z bkarwin $
*/
/**
* @see Zend_Service_Amazon_Ec2_Abstract
*/
require_once 'Zend/Service/Amazon/Ec2/Abstract.php';
/**
* An Amazon EC2 interface to allocate, associate, describe and release Elastic IP address
* from your account.
*
* @category Zend
* @package Zend_Service_Amazon
* @subpackage Ec2
* @copyright Copyright (c) 2005-2010 Zend Technologies USA Inc. (http://www.zend.com)
* @license http://framework.zend.com/license/new-bsd New BSD License
*/
class Zend_Service_Amazon_Ec2_Elasticip extends Zend_Service_Amazon_Ec2_Abstract
{
/**
* Acquires an elastic IP address for use with your account
*
* @return string Returns the newly Allocated IP Address
*/
public function allocate()
{
$params = array();
$params['Action'] = 'AllocateAddress';
$response = $this->sendRequest($params);
$xpath = $response->getXPath();
$ip = $xpath->evaluate('string(//ec2:publicIp/text())');
return $ip;
}
/**
* Lists elastic IP addresses assigned to your account.
*
* @param string|array $publicIp Elastic IP or list of addresses to describe.
* @return array
*/
public function describe($publicIp = null)
{
$params = array();
$params['Action'] = 'DescribeAddresses';
if(is_array($publicIp) && !empty($publicIp)) {
foreach($publicIp as $k=>$name) {
$params['PublicIp.' . ($k+1)] = $name;
}
} elseif($publicIp) {
$params['PublicIp.1'] = $publicIp;
}
$response = $this->sendRequest($params);
$xpath = $response->getXPath();
$nodes = $xpath->query('//ec2:item');
$return = array();
foreach ($nodes as $k => $node) {
$item = array();
$item['publicIp'] = $xpath->evaluate('string(ec2:publicIp/text())', $node);
$item['instanceId'] = $xpath->evaluate('string(ec2:instanceId/text())', $node);
$return[] = $item;
unset($item);
}
return $return;
}
/**
* Releases an elastic IP address that is associated with your account
*
* @param string $publicIp IP address that you are releasing from your account.
* @return boolean
*/
public function release($publicIp)
{
$params = array();
$params['Action'] = 'ReleaseAddress';
$params['PublicIp'] = $publicIp;
$response = $this->sendRequest($params);
$xpath = $response->getXPath();
$return = $xpath->evaluate('string(//ec2:return/text())');
return ($return === "true");
}
/**
* Associates an elastic IP address with an instance
*
* @param string $instanceId The instance to which the IP address is assigned
* @param string $publicIp IP address that you are assigning to the instance.
* @return boolean
*/
public function associate($instanceId, $publicIp)
{
$params = array();
$params['Action'] = 'AssociateAddress';
$params['PublicIp'] = $publicIp;
$params['InstanceId'] = $instanceId;
$response = $this->sendRequest($params);
$xpath = $response->getXPath();
$return = $xpath->evaluate('string(//ec2:return/text())');
return ($return === "true");
}
/**
* Disassociates the specified elastic IP address from the instance to which it is assigned.
* This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.
*
* @param string $publicIp IP address that you are disassociating from the instance.
* @return boolean
*/
public function disassocate($publicIp)
{
$params = array();
$params['Action'] = 'DisssociateAddress';
$params['PublicIp'] = $publicIp;
$response = $this->sendRequest($params);
$xpath = $response->getXPath();
$return = $xpath->evaluate('string(//ec2:return/text())');
return ($return === "true");
}
}
|
