@attr_reader [String,nil] instance_id Returns the instance id if
assigned to an EC2 instance, nil otherwise.
@attr_reader [String,nil] allocation_id
The ID representing the allocation of the address for use with Amazon VPC.
@attr_reader [String] Indicates whether this elastic ip address is for
EC2 instances ('standard') or VPC instances ('vpc').
@attr_reader [String,nil] The ID of the association between this elastic
ip address and an EC2 VPC instance (VPC only).
@attr_reader [String,nil] The ID of the network interface (VPC only).
@attr_reader [String,nil] network_interface_owner_id
The ID of the AWS account that owns the network interface (VPC only).
@return [String] The public IP address.
@return [String] The public IP address.
# File lib/aws/ec2/elastic_ip.rb, line 37 def initialize public_ip, options = {} @public_ip = public_ip super end
@private
# File lib/aws/ec2/elastic_ip.rb, line 151 def self.describe_call_name :describe_addresses end
@return [Boolean] Returns true if this IP address is attached to
an EC2 instance.
# File lib/aws/ec2/elastic_ip.rb, line 72 def associated? !!instance_id end
Releases the elastic IP address.
(For non-VPC elastic ips) Releasing an IP address automatically disassociates it from any instance it's associated with.
@return [nil]
# File lib/aws/ec2/elastic_ip.rb, line 92 def delete if vpc? client.release_address(:allocation_id => allocation_id) else client.release_address(:public_ip => public_ip) end nil end
Disassociates this elastic IP address from an EC2 instance. Raises an exception if this elastic IP is not currently associated with an instance. @return [nil]
# File lib/aws/ec2/elastic_ip.rb, line 106 def disassociate if vpc? client.disassociate_address(:association_id => association_id) else client.disassociate_address(:public_ip => public_ip) end nil end
@return [Boolean] Returns true the elastic ip address exists in
your account.
# File lib/aws/ec2/elastic_ip.rb, line 117 def exists? begin get_resource true rescue Errors::InvalidAddress::NotFound false end end
@return [Instance,nil] If associated, returns the {Instance} this
elastic IP address is associated to, nil otherwise.
# File lib/aws/ec2/elastic_ip.rb, line 80 def instance if instance_id = self.instance_id Instance.new(instance_id, :config => config) end end
@return [String] Returns the public IP address
# File lib/aws/ec2/elastic_ip.rb, line 127 def to_s public_ip.to_s end
@private
# File lib/aws/ec2/elastic_ip.rb, line 145 def describe_call_name :describe_addresses end
@private
# File lib/aws/ec2/elastic_ip.rb, line 133 def resource_id_method :public_ip end
@private
# File lib/aws/ec2/elastic_ip.rb, line 139 def response_id_method :public_ip end