Class: Profitbricks::Nic

Inherits:
Model
  • Object
show all
Defined in:
lib/profitbricks/nic.rb

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Model

#attributes, belongs_to, has_many, #reload

Constructor Details

#initialize(hash, parent = nil) ⇒ Nic

Returns a new instance of Nic.



6
7
8
9
 
# File 'lib/profitbricks/nic.rb', line 6

def initialize(hash, parent=nil)
  super(hash)
  @ips = [@ips] if @ips.class != Array
end

Class Method Details

.create(options = {}) ⇒ Nic

Creates a NIC on an existing virtual server.

The user can specify and assign local IPs manually to a NIC, which is connected to a Private LAN. Valid IP addresses for Private LANs are 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16. In a Public LAN, a random DHCP IP address is assigned to each connected NIC by default. This IP Address is automatically generated and will change eventually, e.g. during a server reboot or while disconnecting and reconnecting a LAN to the internet.

Parameters:

  • options (Hash) (defaults to: {}) —

    parameters for the new NIC

Options Hash (options):

  • :server_id (Fixnum) —

    Identifier of the target virtual server (required)

  • :lan_id (Fixnum) —

    Identifier of the target LAN > 0 that is to be connected to the specified virtual server. If no LAN exists for such ID, a new LAN with the given ID will be created. (required)

  • :ip (String) —

    Public/private IP address.

  • :name (String) —

    Names the NIC

  • :dhcpActive (Boolean) —

    Toggles usage of ProfitBricks DHCP

Returns:

  • (Nic) —

    The created NIC



82
83
84
85
86
 
# File 'lib/profitbricks/nic.rb', line 82

def create(options = {})
  options[:nic_name] = options.delete :name if options[:name]
  response = Profitbricks.request :create_nic, options
  self.find(:id => response[:nic_id])
end

.find(options = {}) ⇒ Object

Returns information about the state and configuration of an existing NIC.

Parameters:

  • options (Hash) (defaults to: {}) —

    currently just :id is supported

Options Hash (options):

  • :id (String) —

    The id of the NIC to locate



92
93
94
95
96
 
# File 'lib/profitbricks/nic.rb', line 92

def find(options = {})
  raise "Unable to locate the Nic named '#{options[:name]}'" unless options[:id]
  response = Profitbricks.request :get_nic, nic_id: options[:id]
  PB::Nic.new(response)
end

Instance Method Details

#add_ip(ip) ⇒ Object

Adds an existing reserved public IP to a NIC. This operation is required, when dealing with reserved public IPs to ensure proper routing by the ProfitBricks cloud networking layer.

Parameters:



38
39
40
41
42
 
# File 'lib/profitbricks/nic.rb', line 38

def add_ip(ip)
  response = Profitbricks.request :add_public_ip_to_nic, nic_id: self.id, ip: ip
  @ips.push ip
  return true
end

#delete ⇒ Boolean

Deletes an existing NIC.

Returns:

  • (Boolean) —

    true on success, false otherwise



56
57
58
59
 
# File 'lib/profitbricks/nic.rb', line 56

def delete
  response = Profitbricks.request :delete_nic, nic_id: self.id
  return true
end

#ip ⇒ Object 



61
62
63
64
65
66
67
 
# File 'lib/profitbricks/nic.rb', line 61

def ip
  if @ips.length <= 1
    @ips.first 
  else
    raise ArgumentError.new("This Nic has more then one IP assigned")
  end
end

#remove_ip(ip) ⇒ Object

Removes a reserved public IP from a NIC. This operation is required, when dealing with reserved public IPs to ensure proper routing by the ProfitBricks cloud networking layer.

Parameters:



47
48
49
50
51
 
# File 'lib/profitbricks/nic.rb', line 47

def remove_ip(ip)
  response = Profitbricks.request :remove_public_ip_from_nic, nic_id: self.id, ip: ip
  @ips.delete ip
  return true
end

#set_internet_access=(value) ⇒ Boolean

Connects or disconnects an existing NIC to a public LAN to get internet access.

Parameters:

  • Internet (Boolean) —

    access (trUe/false)

Returns:

  • (Boolean) —

    true on success, false otherwise



15
16
17
18
 
# File 'lib/profitbricks/nic.rb', line 15

def set_internet_access=(value)
  response = Profitbricks.request :set_internet_access, data_center_id: self.data_center_id, lan_id: self.lan_id, internet_access: value
  return true
end

#update(options = {}) ⇒ Boolean

Changes the settings of an existing NIC.

Parameters:

  • options (Hash) (defaults to: {}) —

    parameters to update

Options Hash (options):

  • :server_id (Fixnum) —

    Identifier of the target virtual server (required)

  • :lan_id (Fixnum) —

    Identifier of the target LAN > 0 that is to be connected to the specified virtual server. If no LAN exists for such ID, a new LAN with the given ID will be created.

  • :ip (String) —

    Public/private IP address.

  • :name (String) —

    Names the NIC

Returns:

  • (Boolean) —

    true on success, false otherwise



28
29
30
31
32
33
 
# File 'lib/profitbricks/nic.rb', line 28

def update(options = {})
  update_attributes_from_hash options
  options[:nic_name] = options.delete :name if options[:name]
  response = Profitbricks.request :update_nic, options.merge(:nic_id => self.id)
  return true
end