VM::EC2::ElasticAddress(3pm)

Usage

  use VM::EC2;
  $ec2     = VM::EC2->new(...);
  $addr    = $ec2->allocate_address;
  $ip      = $addr->publicIp;
  $domain  = $addr->domain;
  $allId   = $addr->allocationId;

Overview

This object represents an Amazon EC2 elastic address and is returned by by VM::EC2->allocate_address().

Methods

These object methods are supported:

 publicIp      -- Public IP of the address
 domain        -- Type of address, either "standard" or "vpc"
 allocationId  -- For VPC addresses only, an allocation ID
 instanceId    -- If the address is associated with an instance, the
                  ID of that instance.
 associationId -- If the address is a VPC elastic IP, and associated
                  with an instance, then the ID of the association.

In addition, the following convenience methods are provided:

$result = $addr->associate($instance_id)

Associate this address with the given instance ID or VM::EC2::Instance object. If successful, the result code will be true for an ordinary EC2 Elastic IP,or equal to the associationId for a VPC Elastic IP address.

$result = $addr->disassociate()

Disassociate this address with any instance it is already associated with. If successful, this method will return true.

$addr->refresh()

This is an internal function called after associate() and disassociate(), and is used to refresh the address object's contents.

String overloading

When used in a string context, this object will interpolate the publicIp.

Releases

6 releases since Debian 8 (Jessie); the text changed 3 times.