Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
VM::EC2::ElasticAddresUser Contributed Perl DocumentVM::EC2::ElasticAddress(3)

NAME
       VM::EC2::ElasticAddress - Object	describing an Amazon EC2 Elastic
       Address

SYNOPSIS
	 use VM::EC2;

	 $ec2	  = VM::EC2->new(...);
	 $addr	  = $ec2->allocate_address;

	 $ip	  = $addr->publicIp;
	 $domain  = $addr->domain;
	 $allId	  = $addr->allocationId;

DESCRIPTION
       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.

SEE ALSO
       VM::EC2 VM::EC2::Generic	VM::EC2::Instance

AUTHOR
       Lincoln Stein <lincoln.stein@gmail.com>.

       Copyright (c) 2011 Ontario Institute for	Cancer Research

       This package and	its accompanying libraries is free software; you can
       redistribute it and/or modify it	under the terms	of the GPL (either
       version 1, or at	your option, any later version)	or the Artistic
       License 2.0.  Refer to LICENSE for the full license text. In addition,
       please see DISCLAIMER.txt for disclaimers of warranty.

perl v5.24.1			  2017-07-02	    VM::EC2::ElasticAddress(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | STRING OVERLOADING | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=VM::EC2::ElasticAddress&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help