Class: OvirtSDK4::NetworksService
- Defined in:
- lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb
Instance Method Summary collapse
-
#add(network, opts = {}) ⇒ Network
Creates a new logical network, or associates an existing network with a data center.
-
#list(opts = {}) ⇒ Array<Network>
List logical networks.
-
#network_service(id) ⇒ NetworkService
Reference to the service that manages a specific network.
-
#service(path) ⇒ Service
Locates the service corresponding to the given path.
Methods inherited from Service
Instance Method Details
#add(network, opts = {}) ⇒ Network
Creates a new logical network, or associates an existing network with a data center.
Creation of a new network requires the name
and data_center
elements.
For example, to create a network named mynetwork
for data center 123
send a request like this:
POST /ovirt-engine/api/networks
With a request body like this:
<network>
<name>mynetwork</name>
<data_center id="123"/>
</network>
To associate the existing network 456
with the data center 123
send a request like this:
POST /ovirt-engine/api/datacenters/123/networks
With a request body like this:
<network>
<name>ovirtmgmt</name>
</network>
To create a network named exnetwork
on top of an external OpenStack network provider 456
send a request
like this:
POST /ovirt-engine/api/networks
<network>
<name>exnetwork</name>
<external_provider id="456"/>
<data_center id="123"/>
</network>
15367 15368 15369 |
# File 'lib/ovirtsdk4/services.rb', line 15367 def add(network, opts = {}) internal_add(network, Network, ADD, opts) end |
#list(opts = {}) ⇒ Array<Network>
List logical networks.
For example:
GET /ovirt-engine/api/networks
Will respond:
<networks>
<network href="/ovirt-engine/api/networks/123" id="123">
<name>ovirtmgmt</name>
<description>Default Management Network</description>
<link href="/ovirt-engine/api/networks/123/permissions" rel="permissions"/>
<link href="/ovirt-engine/api/networks/123/vnicprofiles" rel="vnicprofiles"/>
<link href="/ovirt-engine/api/networks/123/networklabels" rel="networklabels"/>
<mtu>0</mtu>
<stp>false</stp>
<usages>
<usage>vm</usage>
</usages>
<data_center href="/ovirt-engine/api/datacenters/456" id="456"/>
</network>
...
</networks>
The order of the returned list of networks is guaranteed only if the sortby
clause is included in the
search
parameter.
15439 15440 15441 |
# File 'lib/ovirtsdk4/services.rb', line 15439 def list(opts = {}) internal_get(LIST, opts) end |
#network_service(id) ⇒ NetworkService
Reference to the service that manages a specific network.
15450 15451 15452 |
# File 'lib/ovirtsdk4/services.rb', line 15450 def network_service(id) NetworkService.new(self, id) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
15461 15462 15463 15464 15465 15466 15467 15468 15469 15470 |
# File 'lib/ovirtsdk4/services.rb', line 15461 def service(path) if path.nil? || path == '' return self end index = path.index('/') if index.nil? return network_service(path) end return network_service(path[0..(index - 1)]).service(path[(index +1)..-1]) end |