Managing Virtual Networks

Defines a vNet and lists the available operations for managing it.

Virtual networks, or vNets, connect the vServers within an account and connect vServers to an external network.

The APIs and CLI provide operations for:

Use either the cloud infrastructure API actions or the cloud infrastructure CLI command to perform these operations.

About vNets

Describes the types of virtual networks.

A virtual network can be of the following types:

  • Private vNet – A private vNet is created based on the private network from the network domain of the virtual datacenter (vDC). Private vNets are accessible only within an account. All vServers that have membership of a private vNet in common can communicate freely through that subnet.

  • Public network – This type of networks can be shared among several accounts in a vDC. All vServers that share a public network also have external communication beyond vDCs and can be used to host public services.

A vServer is a member of one or more vNets. The membership of a vServer must be specified when the vServer is created.

Creating a vNet

Lists the API action and CLI command for creating a vNet.

A cloud user can create private vNets according to the user requirements and within the limits of the account quota.

A public network available in an account is visible to cloud users. However, a cloud user cannot create a public network. The number of public network IP addresses allocated to the cloud user is controlled by the cloud administrator.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

CreateVnetRequest

iaas-create-vnet


Example 3-9 Creating a vNet using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=CreateVnet&Version=1&AccessKeyId=AK_1&name=privatevnetWebApi&Timestamp=1331058639019&Expires=1331058939019&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST

Example 3-10 Creating a vNet using the Cloud Infrastructure CLI

iaas-create-vnet --base-url https://<EnterpriseControllerHostname>/ --access-key-file ak.file --name myVNET

Viewing vNet Information

Lists the API action and CLI command for displaying a vNet.

A cloud user can get information about vNets. The cloud user can restrict the vNets included in the result by specifying filters. If there is no match, no message is returned and the response is empty.

When viewing vNets, a list of available vNets for the account is returned with the following attributes:

  • ID

  • Name

  • Description

  • Status: In addition to the standard values for status, a vNet reports the NOT CONNECTED status when the vNet is not associated with a vDC server pool. The iaas-connect-vnet operation connects the vNet to a server pool and changes the status to OK.

  • IP address

  • vNet type: public_external or private


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

DescribeVnetsRequest

iaas-describe-vnets


Example 3-11 Viewing vNet information using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=DescribeVnets&Version=1&AccessKeyId=AK_3&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST

Example 3-12 Viewing vNet information using the Cloud Infrastructure CLI

iaas-describe-vnets --base-url https://<EnterpriseControllerHostname>/ -a ak.file

Connecting a vNet

Lists the API action and CLI command for connecting a vNet.

A cloud user can associate a vNet with all the server pools of a vDC.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

ConnectVnetRequest

iaas-connect-vnet


Example 3-13 Connecting a vNet using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=ConnectVnet&Version=1&AccessKeyId=AK_3&vnet=VNET-00cd848c-771a-4091-b3f4-195a090bbc01&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST

Example 3-14 Connecting a vNet using the Cloud Infrastructure CLI

iaas-connect-vnet --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t

Deleting a vNet

Lists the API action and CLI command for deleting a vNet.

A cloud user can delete only private vNets.


Cloud Infrastructure API Action Cloud Infrastructure CLI Command

DeleteVnetRequest

iaas-delete-vnet


Example 3-15 Deleting a vNet using the Cloud Infrastructure API

https://<EnterpriseControllerHostname>/iaas/?Action=DeleteVnet&Version=1&AccessKeyId=AK_3&vnet=VNET-00cd848c-771a-4091-b3f4-195a090bbc01&Timestamp=1318283467620&Expires=1318283767620&SignatureMethod=SHA512withRSA&SignatureVersion=1&Signature=SIGNATURE_HAS_BEEN_REMOVED_FOR_THE_READABILITY_OF_THE_REQUEST

Example 3-16 Deleting a vNet using the Cloud Infrastructure CLI

iaas-delete-vnet --base-url https://<EnterpriseControllerHostname>/ -a ak.file --vnet VNET-5d74972a-bcdd-4714-8c7f-b67d8010f25t