release_address ( $opt )

The ReleaseAddress operation releases an elastic IP address associated with your account.

Releasing an IP address automatically disassociates it from any instance with which it is associated. For more information, see DisassociateAddress.

After releasing an elastic IP address, it is released to the IP address pool and might no longer be available to your account. Make sure to update your DNS records and any servers or devices that communicate with the address.

If you run this operation on an elastic IP address that is already released, the address might be assigned to another account which will cause Amazon EC2 to return an error.

Access

public

Parameters

Parameter

Type

Required

Description

$opt

array

Optional

An associative array of parameters that can have the following keys:

  • PublicIp - string - Optional - The elastic IP address that you are releasing from your account.
  • AllocationId - string - Optional - The allocation ID that AWS provided when you allocated the address for use with Amazon VPC.
  • curlopts - array - Optional - A set of values to pass directly into curl_setopt(), where the key is a pre-defined CURLOPT_* constant.
  • returnCurlHandle - boolean - Optional - A private toggle specifying that the cURL handle be returned rather than actually completing the request. This toggle is useful for manually managed batch requests.

Returns

Type

Description

CFResponse

A CFResponse object containing a parsed HTTP response.

Examples

Release an Elastic IP address.

// Instantiate the class
$ec2 = new AmazonEC2();

$response = $ec2->release_address(array(
	'PublicIp' => '184.73.247.11'
));

// Success?
var_dump($response->isOK());
Result:
bool(true)

Related Methods

Source

Method defined in services/ec2.class.php | Toggle source view (6 lines) | View on GitHub

public function release_address($opt = null)
{
    if (!$opt) $opt = array();
            
    return $this->authenticate('ReleaseAddress', $opt);
}

Copyright © 2010–2013 Amazon Web Services, LLC


Feedback