Class: OpenNebula::VirtualNetwork
- Inherits:
-
PoolElement
- Object
- XMLElement
- PoolElement
- OpenNebula::VirtualNetwork
- Defined in:
- lib/OpenNebula/VirtualNetwork.rb
Constant Summary collapse
- VN_METHODS =
{ :info => "vn.info", :allocate => "vn.allocate", :publish => "vn.publish", :delete => "vn.delete", :addleases => "vn.addleases", :rmleases => "vn.rmleases", :chown => "vn.chown", :chmod => "vn.chmod", :update => "vn.update", :hold => "vn.hold", :release => "vn.release" }
- VN_TYPES =
%w{RANGED FIXED}
- SHORT_VN_TYPES =
{ "RANGED" => "R", "FIXED" => "F" }
Class Method Summary collapse
-
.build_xml(pe_id = nil) ⇒ Object
Creates a VirtualNetwork description with just its identifier this method should be used to create plain VirtualNetwork objects.
Instance Method Summary collapse
-
#addleases(ip, mac = nil) ⇒ Object
Adds a lease to the VirtualNetwork.
-
#allocate(description, cluster_id = ClusterPool::NONE_CLUSTER_ID) ⇒ Integer, OpenNebula::Error
Allocates a new VirtualNetwork in OpenNebula.
-
#chmod(owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u, other_m, other_a) ⇒ nil, OpenNebula::Error
Changes the virtual network permissions.
-
#chmod_octet(octet) ⇒ nil, OpenNebula::Error
Changes the virtual network permissions.
-
#chown(uid, gid) ⇒ nil, OpenNebula::Error
Changes the owner/group.
-
#delete ⇒ Object
Deletes the VirtualNetwork.
-
#gid ⇒ Object
Returns the group identifier [return] Integer the element’s group ID.
-
#hold(ip) ⇒ Object
Holds a virtual network Lease as used.
-
#info ⇒ Object
Retrieves the information of the given VirtualNetwork.
-
#initialize(xml, client) ⇒ VirtualNetwork
constructor
Class constructor.
- #public? ⇒ Boolean
-
#publish ⇒ Object
Publishes the VirtualNetwork, to be used by other users.
-
#release(ip) ⇒ Object
Releases a virtual network Lease on hold.
-
#rmleases(ip) ⇒ Object
Removes a lease from the VirtualNetwork.
-
#short_type_str ⇒ Object
Returns the state of the Virtual Network (string value).
-
#type ⇒ Object
Returns the type of the Virtual Network (numeric value).
-
#type_str ⇒ Object
Returns the type of the Virtual Network (string value).
-
#unpublish ⇒ Object
Unplubishes the VirtualNetwork.
-
#update(new_template = nil) ⇒ Object
Replaces the template contents.
Methods inherited from PoolElement
#id, #name, new_with_id, #to_str
Methods inherited from XMLElement
#[], #add_element, #attr, #delete_element, #each, #each_xpath, #has_elements?, #initialize_xml, #name, #retrieve_elements, #template_like_str, #template_str, #template_xml, #text, #to_hash, #to_xml
Constructor Details
#initialize(xml, client) ⇒ VirtualNetwork
Class constructor
66 67 68 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 66 def initialize(xml, client) super(xml,client) end |
Class Method Details
.build_xml(pe_id = nil) ⇒ Object
Creates a VirtualNetwork description with just its identifier this method should be used to create plain VirtualNetwork objects. id
the id of the network
Example:
vnet = VirtualNetwork.new(VirtualNetwork.build_xml(3),rpc_client)
55 56 57 58 59 60 61 62 63 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 55 def VirtualNetwork.build_xml(pe_id=nil) if pe_id vn_xml = "<VNET><ID>#{pe_id}</ID></VNET>" else vn_xml = "<VNET></VNET>" end XMLElement.build_xml(vn_xml, 'VNET') end |
Instance Method Details
#addleases(ip, mac = nil) ⇒ Object
Adds a lease to the VirtualNetwork
113 114 115 116 117 118 119 120 121 122 123 124 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 113 def addleases(ip, mac = nil) return Error.new('ID not defined') if !@pe_id lease_template = "LEASES = [ IP = #{ip}" lease_template << ", MAC = #{mac}" if mac lease_template << " ]" rc = @client.call(VN_METHODS[:addleases], @pe_id, lease_template) rc = nil if !OpenNebula.is_error?(rc) return rc end |
#allocate(description, cluster_id = ClusterPool::NONE_CLUSTER_ID) ⇒ Integer, OpenNebula::Error
Allocates a new VirtualNetwork in OpenNebula
86 87 88 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 86 def allocate(description,cluster_id=ClusterPool::NONE_CLUSTER_ID) super(VN_METHODS[:allocate], description, cluster_id) end |
#chmod(owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u, other_m, other_a) ⇒ nil, OpenNebula::Error
Changes the virtual network permissions. Each [Integer] argument must be 1 to allow, 0 deny, -1 do not change
189 190 191 192 193 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 189 def chmod(owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u, other_m, other_a) super(VN_METHODS[:chmod], owner_u, owner_m, owner_a, group_u, group_m, group_a, other_u, other_m, other_a) end |
#chmod_octet(octet) ⇒ nil, OpenNebula::Error
Changes the virtual network permissions.
180 181 182 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 180 def chmod_octet(octet) super(VN_METHODS[:chmod], octet) end |
#chown(uid, gid) ⇒ nil, OpenNebula::Error
Changes the owner/group
171 172 173 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 171 def chown(uid, gid) super(VN_METHODS[:chown], uid, gid) end |
#delete ⇒ Object
Deletes the VirtualNetwork
108 109 110 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 108 def delete() super(VN_METHODS[:delete]) end |
#gid ⇒ Object
Returns the group identifier
- return
-
Integer the element’s group ID
201 202 203 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 201 def gid self['GID'].to_i end |
#hold(ip) ⇒ Object
Holds a virtual network Lease as used
140 141 142 143 144 145 146 147 148 149 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 140 def hold(ip) return Error.new('ID not defined') if !@pe_id lease_template = "LEASES = [ IP = #{ip} ]" rc = @client.call(VN_METHODS[:hold], @pe_id, lease_template) rc = nil if !OpenNebula.is_error?(rc) return rc end |
#info ⇒ Object
Retrieves the information of the given VirtualNetwork.
75 76 77 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 75 def info() super(VN_METHODS[:info], 'VNET') end |
#public? ⇒ Boolean
220 221 222 223 224 225 226 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 220 def public? if self['PERMISSIONS/GROUP_U'] == "1" || self['PERMISSIONS/OTHER_U'] == "1" true else false end end |
#publish ⇒ Object
Publishes the VirtualNetwork, to be used by other users
98 99 100 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 98 def publish set_publish(true) end |
#release(ip) ⇒ Object
Releases a virtual network Lease on hold
153 154 155 156 157 158 159 160 161 162 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 153 def release(ip) return Error.new('ID not defined') if !@pe_id lease_template = "LEASES = [ IP = #{ip} ]" rc = @client.call(VN_METHODS[:release], @pe_id, lease_template) rc = nil if !OpenNebula.is_error?(rc) return rc end |
#rmleases(ip) ⇒ Object
Removes a lease from the VirtualNetwork
127 128 129 130 131 132 133 134 135 136 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 127 def rmleases(ip) return Error.new('ID not defined') if !@pe_id lease_template = "LEASES = [ IP = #{ip} ]" rc = @client.call(VN_METHODS[:rmleases], @pe_id, lease_template) rc = nil if !OpenNebula.is_error?(rc) return rc end |
#short_type_str ⇒ Object
Returns the state of the Virtual Network (string value)
216 217 218 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 216 def short_type_str SHORT_VN_TYPES[type_str] end |
#type ⇒ Object
Returns the type of the Virtual Network (numeric value)
206 207 208 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 206 def type self['TYPE'].to_i end |
#type_str ⇒ Object
Returns the type of the Virtual Network (string value)
211 212 213 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 211 def type_str VN_TYPES[type] end |
#unpublish ⇒ Object
Unplubishes the VirtualNetwork
103 104 105 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 103 def unpublish set_publish(false) end |
#update(new_template = nil) ⇒ Object
Replaces the template contents
new_template
New template contents
93 94 95 |
# File 'lib/OpenNebula/VirtualNetwork.rb', line 93 def update(new_template=nil) super(VN_METHODS[:update], new_template) end |