Versions Compared

Old Version 7

changes.mady.by.user Simon Waterhouse

Saved on

compared with

New Version 8

changes.mady.by.user Simon Waterhouse

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Wiki Markup
This design proposes to expose a virtual network interface card (NIC) as a first class object in the CloudStack API. The pattern follows that of the Amazon Elastic Network Interface \[1\].

...

The main functional change arising from this proposal is that security groups, previously associated with a virtual machine will now be associated with a NIC. When a NIC is created via the createNic command, zero or more security groups may be associated with the NIC.

The legacy semantics of the deployVirtualMachine operation will be preserved; if there are security groups specified as part of a deployVirtualMachine command then they will be associated with each of the NICs that get created as a result of that command. For example consider a system with two security groups (sg1 and sg2) and networks (net1 and net2). A command of the form

...

This command would result in two NICs being created, one attached to each of which the specified networks. Each NIC would have security groups sg1 and sg2 associated with it. 

...

Parameter Name

Description

Required

networkid

The Id of the network that the NIC will be attached to

true

securitygroupids

Comma separated list of security group ids to be associated with the NIC

false

ipaddress

Primary IP address of the NIC. If not specified CS will automatically allocate a primary IP address fwill be automatically allocated from the network range

false

secondaryipaddresses

Comma separated list of secondary IP addresses to be associated with the NIC. Cannot be used in conjunction with secondaryipaddresscount parameter

false

secondaryipaddresscount

Number of secondary IP addresses required on the NIC – the addresses will be automatically allocated by CloudStackfrom the network range. Cannot be used in conjunction with secondaryipaddresses parameter

false

account

The account owning the NIC

false

domainid

The id of the domain in which the NIC should reside. If account is used, domainid must also be used.

false

projectid

The project in which to deploy the NIC

false

...